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Tandy 1100 FD $689 
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Tandy 1 000 RL $439 
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Tandy 1000 RLX HD 1 Drive 1 Meg RAM 999.00 
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89.00 OS-9 Development System 89.95 

39.95 Multi-View by Tandy 44 95 
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VIP Integrated Library (disk) 149 95 

TAPE DISK 

25 95 P" 1168 are subject to change without notice. Please 

34 95 34 95 call for shipping charges. Prices in our retail store 

34 95 34 95 may be hi B ner - Send ,or complete catalog. 

34.95 34.95 "Sale prices through 10-15-91 
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What If? 
Editor: 

Thanks for the beautifully framed copy 
of "Print#-2." It will be greatly treasured, 
along with all my other CoCo "stuff." But I 
think if anyone should be receiving gifts 
and kind words. Lonnie Falk belongs near 
the top of the list. It's been people like you. 
Dennis Kitsz. Tom Mix, and Marty 
Goodman that have really put life into the 
CoCo. 

If I had a big enough cosmic spread- 
sheet, I would love to play a "what if?" 
game. If it wasn't for THE RAINBOW, where 
would the CoCo (and Tandy) be now? If 
Mark Data hadn't written their early adven- 
ture games, such as Black Sanctum, would 
I have written my Ship Wreck adventure 
and gotten as involved with the CoCo as I 
have? 

Steve strom 
Minneapolis, Minnesota 

A Supporting Cast 

Editor: 

I want to let your readers know what a 
great company Colorware is. A while back 
I purchased CoCo Ma.x III and Ma.x-io. I 
worked with the programs for a few days 
then set them aside. When I tried to use 
Ma.x- Hi about a month later. I found I had 
reformatted my working copy. I could not 
get a "new" copy of Ma.x-io to work be- 
cause of a missing file. I called Colorware, 
and they replaced the disk even though the 
warranty had expired. I believe that service 
so far above everyday expectations should 
be mentioned. 

Walter Jones 
Georgetown. Delaware 

Wants Cheap MPI 

Editor: 

I am looking for a device that will let me 
connect my disk drive and DC Modem Pak 
to the CoCo at the same time. I have consid- 
ered a Y cable because I don 't want to spend 
a lot of money. What is your opinion of 
using a Y cable. Has William Barden pre- 
sented a project that would allow me to use 
both things at the same time? 

Aaron Farmer 

2055 Burke Road 

Ukiah, CA 95482 

Our concern about using a Y cable to 
connect multiple devices is that the CoCo 
power supply is pretty taxed as it is. Other 
multi-slot devices provide external power. 



However, as long as you remove the ROM 
from the DC Modest Pak it should vt ork. For 
more information, see Pete Fansler's letter 
in this month's "CoCo Consultations." Also 
read the following articles by Marty 
Goodman: "RS-232 Retrofit" (July 1991, 
Page 10) and "Upgrade Your Multi-Pak!" 
(this issue. Page 52). 

Plug 'n' Power Again . . . 

Editor: 

Thank you for such a wonderful maga- 
zine — I love it. I read it from cover to 
cover, and I especially like "Turn of the 
Screw" by Tony DiStefano. I wish he had 
more space to delve deeper into his expla- 
nations of the CoCo's interfacing abilities. 

Recently. I was reading some back is- 
sues and came across a reference (May 1 988, 
Page 1 6) to an "upcoming" article on how to 
use the Radio Shack Appliance and Light 
Controller with the CoCo 3. 1 am very sorry 
I missed this article. Could you tell me the 
issue(s) in which the article appeared? I 
have the ROM Pak for the Appliance and 
Light Controller but cannot make it work 
with my CoCo 3. 

Alan Doherty 
Marstons Mills. Massachusetts 

Sorry. We had anticipated publishing 
such an article at that time. Unfortunately 
none of our leads bore fruit. We would 
certainly consider publishing the article if 
someone submits it. 

. . . and Again 
Editor: 

I have a 5I2K CoCo 3 and a CM-8 Moni- 
tor. I also have a Plug 'n' Power Appliance 
and Light Controller that I can not use with 
the CoCo 3. 1 have to drag out my CoCo 2 
and a color TV in order to change the time 
settings on the unit. Is there anything I can 
do in order to use the controller with the 
CoCo 3? 

Bob Kemether 
Bricktown, New Jersey 

We don ' t have an immediate solution for 
you. Bob. However, it is obvious that people 
are interested. It would appear some devel- 
oper could make a killing from this . . . 

Loves Coverage of OS-9 

Editor: 

I love your articles covering OS-') and 
BASIC09. Since reading Dean Bergmann's 
"Living Without Line Numbers" (August 
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1990. Page 64). I have begun to understand 
some of the power of BASIC09. Just the other 
day I was having trouble understanding the 
instructions in the BASIC09 manual for send- 
ing data to the printer from within a pro- 
gram. But THE RAINBOW came to my rescue 
again with a perfect example in GradeBook 
from "OS-9 Gets the Grades'* (September 
1990, Page 39). Thank you. 

Eric Bailey 

Moonee Ponds. Victoria 

An si nil ia 



Wants CoCo 3 Tech Info 
Editor: 

I want to buy a Color Computer 3 tech- 
nical manual, but I have not been able to 
because I don*t know what it's catalog 
number is. Do you have any information 
that would help? 

David Guilbeau 

67os n. University 

Carencro. LA 70520 

The CoCo 3 service manual is available 
from Tandy National Parts and carries the 
same stock number as the computer (#26- 
3334). You can order the manual from Tandy 
National Parts at any Radio Shack store, or 
call (817) S70-5600. 

Thanks for the Help 

Editor: 

Many thanks for explaining the solution 
to an OS-9 problem I had ("OS-9 Hotline." 
July 1991). I've been beating my head with 
OS-9 for over two years, and I'm finally 
getting to understand it. The next challenge 
for me is to learn assembly language. Thanks 
again! 

Daniel Imanski 
Milwaukee, Wisconsin 

We're glad we could be of service in 
your time of need. And we wish you the best 
of luck in your new quest. 

Monitors and the CoCo 2 

Editor: 

I want to use a composite video monitor 
with my CoCo 2. Is there a way of convert- 
ing the RF output for video? Would such a 
project entail more than fhe average hobby- 
ist is prepared to tackle? 

D'Arcy Brownrigg 

P.O. Box 292 

Chelsea. Quebec .I0X INO 

Canada 



Read "Do-lt-Yoitrself Video Output 
Board" (September 1986, Page 171) for a 
simple circuit that does just what you want. 
This easy-to-build project is a simple am- 
plifier circuit that requires only readily 
available components. 

In Defense of Newsstands 

Editor: 

I'm writing this letter to express my 
concern about your removing THE RAIN- 
BOW from the newsstands. I think this is a 
big mistake. You are the only source left for 
the Color Computer. I have two CoCo 3's, 
and I wouldn't give them up for anything. 
But now I guess I will have to. Let me 
explain. There are a lot of people like myself 
who can't subscribe to your magazine. It 
isn't that we don't want to — we can't 
afford to. 

I know when your magazine hits the 
newsstands, and I'm right there to pick it 
up. When I went to Walden Books this time. 
I didn't really think you were going to do 
what you said. I was wrong. 

I feel you are doing to the public just 
what Radio Shack did. It isn't bad enough 
that Radio Shack discontinued the CoCo 3, 
but now you are telling us you can't help us 
anymore unless we subscribe. That's not 
right. Just because you're a company, out to 
make some money, doesn't mean you turn 
your backs on the public — we're the people 
that make your money. There has to be a 
better way. Don't turn us away. We love 
you. and you're our last hope. Did you stop 
to think that maybe this computer is all 
some of us can afford? 

Enough of my problems — although, 
my problems are your problems. It's like 
you are disowning us just so you can make 
a profit. In the long run. you are going to 
lose a lot of readers because we can't afford 
the subscription. But that's life in the fast 
lane. Right! Good luck. 

Robert Turner, Jr. 
Farmington. New Hampshire 

We believe your frustration, and you 
certainly have a right to feel the way you do. 
But the decisions we make are in THE RAIN- 
BOW'S best interests as a publication. There- 
fore, in the long run they are in our readers' 
best interests, as well. While there are ex- 
ceptions, your case being an example, we 
find that most of our readers subscribe. We 
hope you' II find a way to subscribe, too. The 
SSI subscription rate may he a lot of money 
to some people, but it doesn't add up that 



$3.95 (plus tax) every month for 12 months is 
any cheaper. 

Non-Stop Support 

Editor: 

My wife and I bought our first CoCo in 
late 1985 and started subscribing to THE 
rainbow shortly thereafter. When we 
bought the computer, we thought we would 
just "fool around" with it. Had it been just 
the software available from Radio Shack, 
we probably would have thought the CoCo 
to be very limited. THE RAINBOW showed us 
there were more capabilities to be discov- 
ered. And it still does. 

The CoCo is capable of serving us well. 
It didn't stop working when the next great- 
est thing came out. Those with little income 
to spare can gel more for less money and 
still get excellent results. THERAINBOW isa 
valued magazine, regardless of its size, and 
we are thankful you are still around to make 
the CoCo a worthy investment. 

We would also like to encourage every- 
one to either join or start a users group that 
includes the CoCo. Believe it or not, there 
are people who think software starts and 
stops at Radio Shack. Some don't even 
know there is a RAINBOW magazine. Sev- 
eral people we have encountered didn't 
even know the CoCo could do any serious 
work. When you get these people in a room 
and show them the CoCo's multitasking 
capabilities, it's like you hit them with a 
hammer. If more people supported the clubs, 
imagine the difference it would make. At- 
tend club meetings. If there isn't a club in 
your area, start one. And. please, everyone 
support THE RAINBOW and its advertisers. 
Thanks for letting us air our feelings! 

Mr. and Mrs. Greg Adams 
Sterling. Illinois 

the rainbow welcomes letters to the 
editor. Mail should be addressed to: Let- 
ters to Rainbow, The Falsoft Building, P.O. 
Box 385, Prospect, ky 400S9. Letters should 
include the writer's full name and ad- 
dress. Letters may be edited for purposes 
of clarity or to conserve space. 

Letters to the editor may also be sent to 
us through our Delphi CoCo S!G. From 
the CoCo sio> prompt, type RAI to take 
: you into the Rainbow Magazine Services 
area of the stG. At theRAK<iBOW> prompt, 
type let to reach the i,etters> prompt 
and then select Letters for Publication. Be 
sure to include your complete name and 
address. 
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Subscribe to these convenient services 
and receive each month's programs in a 
ready-to-run form. No more long tedious 
hours wasted typing! No more red eyes 
and sore fingers! All you do is load and run, 
using the current issue of THE RAINBOW as 
documentation. 

OS-9 programs are available too! One side of 
the RAINBOW ON DISK is formatted for the 
OS-9 operating system (OS-9 pro- 
grams cannot be put on tape) so 
you can get all the great pro- 
grams in the magazine. 

A one-year subscription 
to THE RAINBOW and RAINBOW 
ON TAPE is only $91 in the U.S., 
$1 08 in Canada, $1 53 foreign sur- 
face rate and $188 foreign airmail. 

A one-year subscription to THE 
RAINBOW and RAINBOW ON DISK is 
only $1 15 in the U.S.. $138 in Canada, 
$1 83 foreign surface rate and $218 foreign 
airmail. U.S. currency only. 




Back issues of both RAINBOW ON 
TAPE and RAINBOW ON DISK are also avail- 
able! (see our back issue ad in this issue) 
RAINBOW ON TAPE back issues 
are available beginning with the April 
1 982 issue. A single copy of RAINBOW 
ONTAPE is $1 within the U.S., $1 2 in all 
other countries. The annual subscription 
for RAINBOW ON TAPE is $80 within the 
U.S.:$90 in Canada; and $105 for all other 
countries. U.S. currency only. 

RAINBOW ON DISK back issues are 
available beginning with the October 1 986 
issue. A single copy of RAINBOW ON 
DISK is $12 within the U.S.. $14 in 
Canada. $16 in all other coun— 
ries.The annual subscription for RAIN- 
BOW ON DISK is $99 within the 
U.S.;$115 in Canada; and $130 for all 
other countries. U.S. currency only please. 

Subscribe today and start enjoying THE 
RAINBOW and your CoCo the easy way, 
without the fuss! 



and Save Money Too! 



Yes! Sign me up for a joint 1 -year subscription {12 issues) to: 

-I THE RAINBOW and Rainbow on Tape J THE RAINBOW and Rainbow on Disk 



J New _I Renewal (attach labels) 



Name 

Address 
City _ 
State 



_J My check in the amount of 



is enclosed. 



.Zip 



charge to: J VISA 'J MasterCard J American Express 

Account Number 

Expiration Date Signature 



Use our convenient subscription envelope inserted in this magazine. For credit card orders call(800) 847-0309, 9a. in. to 5 p.m. EST. 

All other inquiries call (502) 228-4492 

* Pa) mi'iil must accompan) order, we do not bill. I .S. currency onlj . please. Kentucky residents add 6 r /i sales lax: ( anadian residents . 7% GST. Please 

allow ft to X weeks for deliver] of first copies. All subscriptions begin with the current issue. 

Please note : While group purchases of RIANBOW ON TAPE ami RAI\B< >w < )\ DISK are permitted (and multiple subscriptions are c\ HI discounted, if purchased 

in one order from a cluh). no license 10 make copies is conveyed or implied. Unauthorized coping of any copyright product is strictly illegal. 
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COST OP 20 EVENING HOURS 
OF DOWNLOADS AND CHAT 



On DELPHI'S 20/20 Advantage Plan, you get 20 hours of connect time each month for 
only $20. Additional time is only 2 cents/minute. No other full-featured online service 
even comes close! 

And those are 20 hours of real online fun and productivity. Download files, chat with 
friends, send electronic mail, play multi-player games, and make travel reservations. 



Join DELPHI now for only $39.95 and your first 
20 hours are free. With your CoCo and 
modem: 

• Dial 1-800-365-4636 

• At Username: type JOINDELPHI 

• At Password: type COCO20 



DELPHI 



THE WORLD'S PREMIER ONLINE 
INFORMATION SERVICE 

800-544-4005 • 617-491-3393 



Already a DELPHI member? Type GO USING ADVANTAGE 




Print#-2 



A New Generation 



As you may know. I end up 
writing these columns sev- 
eral months ahead of lime. 
just as most of our editorial 
material is put together in 
advance. This is primarily due to the prob- 
lems of the magazine printing industry rather 
than something we do. If we could send you 
our pages as we put them together, though. 
you*d be getting your information a lot 
more quickly. 

The problems with deadlines is what 
prompts me to be in a generally jolly mood 
in October (when the Holiday issue dead- 
line comes around), but sometimes it is one 
of the more difficult things we have to deal 
with here. 

Right now it is very difficult because, as 
you saw from the September issue, we are 
beginning an in-depth look at the new 
generation of "Color Computers" with an 
evaluation of the System IV from Delmar. 
Obviously the System IV is "in house." and 
our technical types have been working on it 
for the review. We're covering it first be- 
cause it was "first in." but the Frank Hogg 
Laboratories Tomcat is also in house now. 
Expect our techies to work it over and 
report on it in the November issue. Cover- 
age of the M.vt/i is scheduled for December. 

Those are all the new computers we 
have. At RAlNBOWfest Chicago in 1990 (now 
is months ago), two companies announced 
plans to make what we were calling fourth- 
generation computers available as new 
"CoCos." These companies are Frank Hogg 
Laboratories and Interactive Media Sys- 
tems (IMS). In addition. Delmar Company 
introduced the System iv to the CoCo 
Community at the Atlanta CoCofest in 
October. 1990. 

By far the most jazzy of the computers, 
at first blush, seemed to be IMS' MM/I 
machine. Working with a consortium of 
different people. IMS was certainly the most 



active marketer, had the best media presen- 
tation and seemed to have every feature 
everyone ever wauled. 



T ou can form 
an opinion as to 
whether you 
want to "move 
up" to one of the 
new computers. 



By contrast. Delmar kept a pretty low 
profile. Its System IV was basically an in- 
dustrial Motorola-68000-based system that 
promised the capability to run the better and 
faster OS-9/68000 software — all of this the 
"big brother" to our r>xo9-based CoCo. 
Delmar had to work out some problems in. 
essentially, converting an industrial com- 
puter for use by the personal-computer 
market. In the year that has passed, they 
have done just that. 

In the middle of the road (promotion- 
wise) was Frank Hogg. His approach, inter- 
estingly, was to build a totally new com- 
puter, the Tomcat, but to allow it to go 
either way — as a Color Computer or as a 
68000 computer. The 68000 part of the Hogg 
project would be accomplished by using a 
board which he already had available. 

The Tomcat ran into many of the prob- 
lems inherent to building new technology. 



including the perennial one that seems to 
infest the computer industry as a whole — 
"let's just add this one other thing." To his 
credit. Hogg never officially took orders 
for the Tomcat until his new board was 
finished. As of today, there is a Tomcat 
computer here at the rainbow. There is a 
System iv. And there is an MM/i. 

Knowing we wanted to review these 
new computers (or any other new comput- 
ers that appeared to address the CoCo 
market), we set deadlines based on discus- 
sions with the manufacturers at RAlN- 
BOWfest in I99i. Essentially, we told the 
manufacturers we must have production 
machines — real computers — that were 
truly offered for sale to the general public. 
Although there are a host of technical 
differences, schemes and philosophies be- 
tween these three computers, they are all 
seemingly available, given some slight 
exceptions. We will go into these in our 
reviews. But you should know the MM/i 
comes (as of now. anyway) in kit form, 
which means you have to put it together. In 
all honesty, this is nowhere near as difficult 
as it may sound. 

If you have read last month's review of 
the System IV. and do read November's and 
Decmber's scheduled reviews of the Tom- 
cat and MM/l. you should be able to form an 
opinion as to whether you want to "move 
up" from your Color Computer to one of 
these systems and. if so. which one you 
might choose. As these computers take 
hold, we plan to address some 68000 issues 
and review 6X000 software. We will do this, 
primarily, as we see evidence of "upward" 
migration to these systems. We do plan, of 
course, to continue our coverage of the 
CoCo and of OS-9 as well. 

Should you "move up?" I'll address that 
issue in a future column. 

— i i urn ii- Falk 
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Rainbow 
Back Issues 




BACK ISSUES STILL AVAILABLE 

Have you explored ihe wealth of information in 
our past issues? From our very first, four-page 
issue to many with more than 300 pages of 
material, it's all just for CoCo users — a great 
way to expand your library! 

A WORLD OF INFO 
AT A BARGAIN PRICE 

All back issues sell for the single issue cover 
price. In addition, there is a S3.50 charge for the 
first issue, plus 50 cents for each additional 



issue for postage and handling if sent by United 
Parcel Service. There is a $5 charge for the first 
issue, plus a SI charge for each additional issue 
on orders sent by U.S. Mail. UPS will not deliver 
to a post office box or to another country/ 

MOST ISSUES STILL AVAILABLE 

Available issues through June 1982 are pro- 
vided on white paper in a reprint form. All 
others are in regular magazine form. VISA. 
MasterCard and American Express accepted. 
Kentucky residents please add 6 percent sales 



tax: Canadian residents. 7 percent GST. In order 
to hold down costs, we do not bill, and no 
C.O.D. orders are accepted. 

Due to heavy demand, we suggest you order the 
back issues you want now while supplies last. 
To order, review and fill out the form below and 
mail it with your payment. 

For greater convenience, order through the 
Rainbow Magazine Services area of our Delphi 
CoCo SIG. 
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A how-to for transferring 
files and programs between 
Disk BASIC and OS-9 



Making 
the Move 



by Tim Kientzle 



A major source of frustration in the 
CoCo community is the splii be- 
tween Disk BASIC and OS-9. 
Those who try to use OS-9 ex- 
^ clusively are often frustrated 
by the poor selection of major applications. 
Often they must switch back to Disk BASIC 
for these applications. On the other hand. 
OS-9 makes it easy to develop and use many 
small programs which can be combined to 
perform a wide variety of tasks. Further, the 
better programming tools available under 
OS-9 are encouraging a lot of developers to 
write new software for that environment 
rather than for Disk BASIC. 

The split between OS-9 and Disk BASIC 
would be more tolerable if these two sys- 
tems could easily read and write the same 
disk formal. This is unfortunately not the 
case. However, there are several programs 
available that ease the transfer of files be- 
tween the two disk formats. We'll look at 



Tim Kientzle is currently pursuing a doc- 
torate in mathematics at the University of 
California at Berkeley. He is the author of 
v-Term and has worked with the Color 
Computer since /9.V2. 



how to set up and use the two most popular 
such programs, and briefly mention several 
others. 



I. Stan the computer in Disk BASIC. 

2. Formal a Disk BASIC disk. 

3. Copy to the newly formatted disk 
the files you want to transfer. 

4. Run RS20S9 . BAS. When it has fin 
ished. the disk can be read by OS-9. 

5. Boot OS-9. 

6. Copy the files from the Disk BASIC 
disk to a disk that was formatted by 
OS-9. 

7. You can now use the OS-9 files as 
you want! 

Figure I: Using RS20S9.BAS 



What Will it Mean for Me? 

Once you know how to transfer files 
between the systems, you'll be able to lake 
advantage ofthe different programs that are 
available under both OS-9 and Disk BASIC. 
As an example, one member of a local 
CoCo club uses a Disk BASIC word proces- 
sor to create large databases by entering one 
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1. Get copies of ipatch and the cC3Disk.ipc file. (Both are available on the major information services and many bulletin boards.) 
If you download the files with a Disk BASIC terminal program, you'll need to transfer them to an OS-9 disk with rs20S9.bas. 
as described in the article. 

2. Copy ipatch to your cmds directory, and set the execute attributes by entering 

attr cmds/ipatch e pe 

3. Copy thecc3Disk. ipc file to your modules directory. (If you*re using the standard CoCo 3 OS- 1 ) Level II. the modules directory 
is on a different disk. If you have to swap disks, enter load ipatch so that ipatch will be in memory for later use. then change 
the disks. Remember to enter chd /dO,-chx /dO/cmds to tell OS-9 to use the new disk.) 

4. Enter chd modules and di r to get a listing of the modules directory. You should see cc3disk . dr and cc3disk . ipc listed. What 
we want to do is create a new cc3disk.dr using cc3disk.ipc to patch the old one. 

5. Enter rename cc3disk.dr cc3disk.old.dr to rename the original file in case you need it at a later date. 

6. Now do the actual patching by entering ipatch cc3disk.ipc cc3disk.old.dr cc3disk.dr. which tells ipatch to use the 
instructions in cc3disk.ipc to patch cc3disk.old.dr to get cc3disk.dr. 

7. You now have to build a new boot disk, using either conf ig or os9Gen. that includes the new cc3Disk driver in the file 
cc3disk.dt. 

Figure 2: Using ipatch to Create a New Driver 



item on each line in a file. He then moves 
these databases over to OS-9 where he can 
use small utility programs to search the text 
files, sort them, or display information in 
particular formats. This whole setup hinges 
on the ability to easily move files between 
the two operating systems. 

People trying to get started with OS-9 
often find that being able to transfer files is 
a necessary prerequisite. A typical question 
on the online information services (Delphi. 
CompuServe, etc) comes from a person 
who has just downloaded an OS-9 file using 
a Disk BASIC terminal program, and who is 
trying to figure out how to use the new 
download with OS-9. The first step is getting 
the program onto an OS-9-formatted disk. 

Why Are the Formats Different? 

os-9 and Disk BASIC were developed by 
different groups of people with different 
goals. It is a common misconception that 
OS-9 was developed for the Color Com- 
puter. If that were so. it would be reasonable 
to ask why OS-9 doesn't use the same disk 
format as Disk BASIC. In fact, the two oper- 
ating systems were developed (at about the 
same time) for different purposes. 

Disk BASIC was developed for Tandy by 
Microsoft. Microsoft based the disk format 
on a similar disk format they had success- 
fully used for other computers. (The same 
ideas were used in the MS-DOS disk format.) 
This disk format is good for use on floppies, 
but lacks some features (such as support for 
different-sized disks and subdirectories) 
present on larger computers. 

OS-9 was developed by Microware as a 
UNIX-style operating system for real-time 
control. Since the people developing OS-9 



used large UNIX systems as a model, they 
came up with a very different disk format 
— one that readily adapts to different-sized 
disks, and that has heirarchical directories 
and other features. The fact that OS-9 was 
designed to be easily ported to different 
computers that use the 6809 microprocessor 
is what allowed Tandy to offer it for the 
Color Computer. 

It is important to understand thai the 
basic structure of tracks and sectors is the 
same on OS-9 disks as it is on Disk BASIC 
disks. The real difference in the formats is 
that OS-9 uses Track to start its directory 
structure, while Disk BASIC stores its single 
directory on Track 17. 

Enough Talk! What Do I Do? 

There are two basic ways to transfer files 
between Disk BASIC and OS-9. The biggest 
difference between them is that one method 
uses a Disk BASIC program and the other 
uses an OS-9 program. The Disk basic route 
is somewhat easier to set up. and the OS-9 
route is easier to use after it's already setup. 
We'll look at the Disk BASIC route first, 
since that's where most people need to start. 

Pushing From One Side . . . 

There are a number of Disk BASIC/OS-9 
transfer programs available in the data- 
bases of the major information services. 
The one I'll use is rs20S9.bas. although 
many other versions are available (rs- 
os9 . bas, dosor9 . bas, and other variations). 
All of these programs work in essentially 
the same way: You first put the files you 
want to transfer on a Disk BASIC disk. Then 
you run the program (in this case, RS20S9), 
which enables OS-9 to read the files on the 



disk. Finally, you boot OS-9 and simply 
copy the files to a true OS-9 disk — one that 
has been formatted using the OS-9 format 
command. Figure I shows the steps in- 
volved in this process. 

As I stated before. OS-9 and Disk BASIC 
use different parts of the disk to store their 
directory information. RS20S9 looks at the 
Disk basic directory information and cre- 
ates enough of an OS-9 directory to let OS-9 
find the files. After RS20S9 runs, the disk 
contains two directories: A Disk BASIC 
directory on Track 17 and an OS-9 directory 
on Track 0. 

Be forewarned, however: You should 
not write to this specially formatted disk 
from O.S-9. The OS-9 directory created by 
RS20S9 isn't complete, and problems may 
occur. Also, writing files to the disk from 
OS-9 won't change the Disk basic direc- 
tory, so there's no way for Disk BASIC to 
know that OS-9 has stored files there. To 
avoid the obvious confusion of having the 
two systems believe that different files are 
on the same disk. I suggest you avoid using 
it like a true OS-9 disk. 

There are a few common limitations to 
such programs, though. First, the part of the 
disk where the OS-9 directory will be writ- 
ten should be blank. Some versions of 
RS20S9 are smart enough to move any Disk 
BASIC files that fill thai part of the disk, 
while some simply report an error. Still 
others overwrite the data on that part of the 
disk, thus destroying the data that you're 
trying to transfer. For this reason, you should 
always start with a freshly formatted disk, 
and move only a few files at a time to avoid 
filling Track 0. 

A second limitation is that most versions 
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of RS20S9 . bas build only a relatively small 
OS-9 directory, and can thus handle only a 
few files. Perhaps the most confusing limi- 
tation is that most such programs can handle 
only files smaller than 32K. This is due to the 
way that Disk BASIC handles certain file- 
position calculations. At least one version 
of BS20S9 (in particluar, cocoos9 .bas) has 
been improved to handle larger files. But if 
you will be transferring files often, or trans- 
ferring many large files, you should proba- 
bly be using one of the OS-9 utility programs 
to perform the transfer. 

The caveats to using RS20S9 are summa- 
rized as follows: 

Always start with a blank disk. 
Transfer only a few files at a time. 
Don*t transfer files larger than 32K 
unless you know you have a ver- 
sion of RS20S9 that can handle it. 

At one time, there was a Disk basic 
program that could decipher enough of the 
OS-9 directory structure to read files from an 
OS-9 disk and write them to a Disk BASIC 
disk. I saw this a long time ago but unfortu- 
nately cannot remember where, and I have 
not been able to find it again. 

. . . Pulling Prom the Other 

There are several programs available 
that run under OS-9 and allow you to copy 
files between Disk basic and OS-9 disks. 
This obviously works best if you have two 
disk drives, though you can usually get by 
comfortably if you have one drive and a 
RAM disk for OS-9. Since two disk drives are 
strongly recommended for OS-9 use in 
general, 1*11 assume you have two. 

The program I describe in this section is 
rsdos, which is available on both Compu- 
Serve and Delphi. The commercial OS-9 
programs available for such transfers work 
in much the same manner as rsdos. It is 
worth noting that OS-9 programs to copy 
files between MS-DOS and os-9 disks work 
very similarly, and usually the necessary 
setup is identical. 

Some OS-9 floppy -disk drivers (an OS-9 
driver is a program that knows how to talk 
to certain types of devices) have special 
abilities that let an OS-9 program read raw 
data from a non-OS-9 disk. If the program 
can read the raw data, then it can figure out 
the Disk BASIC directory, find the file infor- 
mation, and copy the file to an OS-9 disk. 
Unfortunately the OS-9 floppy-disk driver 
(called cc3Disk) supplied with OS-9 Level 
II doesn't have this ability. cc3Disk reports 
an error whenever it sees a non-OS-9 disk. 
To get this ability, you need to either alter 
cc3Disk or replace it with a third-party 
commercial disk driver, such as SDisk3. or 
the special drivers that come with one of the 



no-halt disk controllers. (Note: The Disto 
no-halt drivers don't support reading and 
writing of MS-DOS disks because of the way 
the hardware works in the no-halt mode, 
though it works fine for reading and writing 
Disk BASIC disks. If you want to read and 
write MS-DOS disks also, you'll need to use 
either a patched version of Tandy's cc3Disk 



consider one. All of these require D.P. 
Johnson's SDisk3 replacement disk driver 
for Level II, or SDisk for use with Level I. 
Also they all allow you to read, write, and 
format MS-DOS disks. 

Granite Computer Systems' GCS File 
Transfer Utilities support MS-DOS. Disk 
basic. Flex and •Mini-Flex formats, and 



To read a directory of a Disk BASIC disk in Drive /dl: 




rsdos 


-dir 


/dl 


To 


get a file from 


a Disk BASIC disk in /dl and put it on an OS-9 disk in /do: 




rsdos 


-get 


/dl RSFILE.EXT /dO/file.ext 


To 


put a file 


from an os-9 disk onto a Disk basic disk: 




rsdos 


-put 


/dl RSFILE.EXT /dO/file.ext 

Figure 3: Typical rsdos Usage 



or a commercial replacement with the con- 
troller in the normal "halt" mode.) A method 
for altering cc3Disk is shown in Figure 2. 

Once you have modified cc3Disk or 
replaced it with an improved driver, you 
can use Bob Santy's freely-available rsdos 
program, or one of several commercial 
programs to copy files between Disk BASIC 
and OS-9 disks. To use rsdos, with a Disk 
BASIC disk in Drive 1 and an OS-9 disk in 
Drive 0. you use commands like those in 
Figure 3 to accomplish the transfer. For 
more detailed usage, consult the documen- 
tation files that accompany rsdos. 

Most people find going the OS-9 route 
considerably more convenient, once it's set 
up. than using RS20S9. The catch of course 
is that you must get the ipatch and rsdos 
programs and the cc3Disk . ipc file onto an 
OS-9 disk in order to make the changes and 
use rsdos. The usual procedure is to get 
RS20S9 first, use it to transfer the necessary 
files to get rsdos working, and use that for 
future transfers. 

The setup for using the OS-9 utilities is 
unfortunately more complicated than it 
would be if the standard cc3Disk driver 
included the needed abilities. But once 
installed, transferring files between Disk 
BASIC and OS-9 can be quite routine. 

Options, Options 

Also available on the information serv- 
ices is Bob Santy's pcdos, which can read 
and write MS-DOS disks. This program works 
almost identically, and uses the same 
patched version of cc3Disk. 

There are also several commercial pack- 
ages available and. especially if you plan on 
doing a lot of file transfers, you may want to 



sport a point-and-click Multi-Vue interface 
for ease of use. Granite Computer Systems 
also carries SDisk and SDisk.i. 

D.P. Johnson's MSF MS-DOS File Man- 
ager is similar to the one available for OS-9/ 
6K000 systems. Once installed in your boot 
file. MSF lets you read and write MS-DOS 
disks as if they were OS-9 disks. You simply 
use the standard os-9 utilities on Drive /mso 
to access an MS-DOS disk in Drive 0, just as 
you would use those same utilities on /do to 
access an OS-9 disk. D.P. Johnson also has a 
set of PC-XFer utilities that function much 
like Bob Santy's programs, but include the 
ability to format an MS-DOS disk. 

Being able to transfer files quickly and 
easily opens up a new world for Disk BASIC 
and OS-9 users alike. Each system has its 
own advantages, and each offers software 
that isn't available for the other. The key to 
taking advantage of both worlds is all in 
how you make the move. 

Editor's Note 

We wanted to give readers a head start 
in transferring files between Disk BASIC and 
OS-9, so we called Bob Santy to ask his 
permission to include rsdos, ipatch and 
the other necessary files on RAINBOW ON 
DISK. In the interest of encouraging the use 
of OS-9 in the CoCo Community, Mr. Santy 
graciously agreed to our request. The pro- 
grams and patch files are located in the 
cmds. doc and patches directories of this 
month's disk. If you intend to use the Level 
II program, rsdos, you must still patch the 
cc3Disk module as described in Figure 2 of 
this article. We were unable to contact the 
author o/rs20S9.bas, so we cannot pro- 
vide that program on the disk. ff^\ 
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Finally, there's NO need to leave OS-9 to produce sophisticated-looking newsletters, signs, or 
documents! Create headlines & columned text, utilizing different fonts, clipart pictures, fill patterns, 
and text, and create publications that have that PRO-look! Comes complete with fonts, pictures, and 
fills, ready-to-run! Requirements: 256k CC3, OS-9 Iv 2, mouse or joystick. Printers currently 
supported include Epson-compatibles (Star, etc.), Tandy DMP-105/6, 130/2. 4iA Q QC 



CoCoPRO! RS-232 PAK & KIT 

Created by Marty Good man. FULLY-compatible with the Slotpak, 
Multipak, or Y-cable. Buy the pak complete, or purchase the kit 
and convert your own DCM pak into a usable, working RS-232! 

Pak- $44.95 Kit- $26.95 

512k Upgrade w/Lightning software 

The BEST! New 1 20ns DRAM, PP board $69 

AMT Star 2400-baud modem $95 
Magna vox 1 CM 135 w/cable $299 

Slotpak-3 Multipak replacement. 5?^ 

12-volt adapter for above $15 

IBM Keyboard interface $79 

Disto Super Controller 1 $89 

Disto HDISK/232 board $69 



20-meg Hard Disk 

Complete, ready to plug-n-run! Ken-Ton interface. Fully 
tested & formatted. Requires MPI, Slotpack, or Y-cable. 
Can be partitioned for both DECB & OS-9 t*>QQ 
with optional RGB-DOS and OS-9 drivers. 9-3~~ 



Presto-Partner 

Data Merger 

Disk Mgr. Tree 

Multi-Menu 

EZGen 

File Sys Repack 

RSB 

MVBanner 



$29.95 
$19.95 
$29.95 
$19.95 
$19.95 
$29.95 
$39.95 
$19.95 



Data Windows 
Level II Tools 
The Zapper 
OS9 Lv2 BBS 
File Recov. Sys 
Wild & MV 
WPShel 
MVCanvas 



$59.95 
$24.95 
$19.95 
$29.95 
$24.95 
$19.95 
$21.95 
$49.95 



UltiMusE III $54.95 



Checkbook Plus/OS-9! |UST released! Incred- 
ible new point & click checkbook manager from Sub-Etna. 
Includes full graphing, so you can see just where your 
money goes. Includes pull-down menus,full editing, pop- 
down calculator, and many other features not found 
elsewhere... except, of course, in the RSDOS version! Please 
specify RSDOS or OS-9 when ordering. $24- 95 




PRO! 



A Division of DNM Enterprises. Inc. 



P.O BOX 763 YPSILANTI Ml 48197 



Include $4 S&H on all U.S. orders, $5 CDN. 

COD $4 additional. VISA/MC add 5%. 

Call for shipping on HDs & monitors 



NewsARTQ9 



NewsART09 A thru Z is an 
incredibly diverse collection 
of ClipArt for use with News- 
paper09, including over 
1300 usable images! With this package in your publishing "arsenal", you 
can produce high-quality printed documents , with appropriate illustra- 
tions for virtually any subject. Individual sets A-Z 
are $9.95 ea, 26 for $99.95. Req. DS 40-track drive. 



$99.95 




Introducing a NEW set of 27 
OS-9 Iv 2 tools to make your 
life easier! Get Window Utili- 
ties (such as a screen-saver, 
global search & replace w/wildcards, a go command to easily change 
dirs, and more), Process Scheduling utils such as demon (background 
task mgr., w/scheduling), Script File utils like dircopy, I/O Port utils like 
an autodialer for voice calls, and many more not 
listed. You'll wonder how you've done without these ! 



$34.95 



SimpCy better 



The BEST CC3 word-proces- 
sor ever, is NOW ON SALE! 
SB is easy for a novice to 
learn, yet powerful enough to satisfy the needs of the most advanced 
user! Features include windowing (2 documents open at once), print 
spooling, pop-up calculator, type-ahead buffer, auto-saving of work as 
you go, easy creation of table of contents or indexes, serial-numbering, 
onscreen representation of fonts and underlining (instead of cryptic 
codes), filling in of pre-printed forms, French-language characters, and 
MUCH more! All these features, plus dozens more, at HALF the price of 
competing wordprocessors. Includes new, professionally-typeset manual. 
Owners of earlier version may upgrade to v. 2.0 a<*q Og 
for $20 + original disks. Reviewed in Feb. '90 «p^«/.«7«3 
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DISK \l\\\<.m'S MTKIMK I 



DMA is a new file management utility set 
for use with the CoCo-3 under DECB. Each 
utility in the set has been created to aid in 
organizing disks and the files they contain. 
These utils are combined into a single, 
memory-resident environment. DMA's features include full wildcard 
file-handling, point-and-select filename features w/tagging, and 8 
online help screens. MANY more features than any similar product. 
At last, you can get your disks organized quickly 
and easily, with the Disk Manager's Apprentice! 



$29.95 



VISA/MC ORDERS 1 .800.937.7746 

(TOUCH-TONE PHONE REQUIRED) 

ALL OTHER CALLS 1 .3 1 3.48 1 .3283 

1 -9 PM EST MON-SAT 

For a 12-mo. subscription to our catalog of used soft- & 
hardware at INCREDIBLE prices (20-90% off), send $15 




Delphi 
Bureau 



Database Reconstruction 



by Eddie Kuns 

OS-9 SIG Database Manager 



Last month I promised to present the 
new primary keywords for use in 
the 0S9 Online databases. First, let 
me explain some of the reconstruc- 
tion. Figure 1 shows the current list 
of topics and Figure 2 shows the proposed 
list of new topics once the reconstruction is 
finished. The names in Figure 2 aren't the 
final topic names — the final topic names 
will be unique in the first three to five 
characters. 

You'll notice that several topics have 
been deleted: Users Group. Utilities. 
Patches. Grits & Gravy and 68K-OS9. With 
the dissolution of the OS-y Users Group, it 
doesn't seem sensible to have the entire 
Users Group library on Delphi in its own 
topic. Thus, all these groups will be taken 
off Delphi and the last version of the OS-9 
Users Group library will be uploaded slowly 
into the appropriate topics. The Utilities 
database has been merged into the Applica- 
tions database. The patches in the Patches 
database have been moved to where the 
item being patched would belong. A patch 
to CC3Disk would be in System Modules 
(6809); a patch to OSTerm would be in 
Telecom (6809); a patch to dEd would be in 
Applications. This should make patches 
easier to find and the most recent version of 
a program easier to figure out. The Grits & 
Gravy topic was never heavily used and is 
thus being discarded. The 68K-OS9 topic is 
being replaced by several topics for OS-9/ 
68000, preparing for the fact that many 



Eddie Kuns is pursuing a PhD in physics at 
Rutgers University. He lives in Aurora, 
Illinois, and works as a programmer and 
researcher at Fermilah. Eddie is co-man- 
ager of the CoCo SIG: his username is 
EDD1EKUNS. 



members of the OS-9 SIG are buying or have 
bought OS-9/68000 machines. 



General Information 

Users Group 

Applications 

Utilities 

Device Drivers 

Patches 

Telcom 

Graphics & Music 

Programmers Deh 

Grits & Gravy 

68K-OS9 

Rainbow OS-9 Material ($) 

Tutorials & Education 

System Standards 

New Uploads 

Figure 1: Current 
Database Topics 




The Graphics & Music database is being 
split into two databases: Games & Graphics 
and Music & Sound. These databases won't 
be further split into 6809 and 68000 databases 
because the sound and graphics files are 
generally transportable across machines 
even when the programs to display or play 
them aren't. 

Two databases have been somewhat 
redefined. Many files have been moved 
into the Programmer's Den, which now is 
the home for any files that aid program- 
ming. This includes libraries, sample source 
code, programming utilities (such as cb and 
1 i nt), and compilers and interpreters. The 
System Modules database topics will be the 
home for all operating system-related Files, 
such as new device drivers, patches to the 
Kernel, and information about operating 
system internals. There will be two data- 



bases for System Modules: one for the 6809 
and one for 68000. Watch the OS-9S1G Forum 
for the latest news on the progress of the 
reorganization. 

OS-9 Database Keywords 

When you are creating a new group 
using the SUBMIT command, you are asked 
to enter a primary keyword. Each database 
topic has a limited number of primary 
keywords that hopefully will cover all 
groups ever to be submitted to that topic. So 
far. only the General Information and 
Applications databases have new primary 
keywords. 



General Information 
Tutorials & Education 
Applications (6809) 
Telecom (6809) 
System Modules (6809) 
Games & Graphics 
Music & Sound 
Programmers Den 
Applications (68000) 
Telecom (68000) 
System Modules (68000) 
Rainbow OS-9 Material ($) 
Standards 
New Uploads 

Figure 2: Proposed 
Database Topics 



Here are the new primary keywords for 
the General Information database: 

• Announcements 

• Archives 

• Humor 

• News 

• Reviews 

• Update 
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From: 80S1A: :JBUCATA 

To: EOQIEKUNS, GREGL. TiMKIENTZL 

Subj: This isn't a real message 



E, 



skemper: 



Figure 3: Retrieved Mail Message Header 



Most of these keywords are self-explana- 
tory. The difference between an announce- 
ment and news is that news is later informa- 
tion about something that has already been 
announced. An announcement is the 
first information in the SIG about a 
product. Updated documentation 
and errata sheets would use the the 
Update keyword. 

The new primary keywords for 
the Applications database (where 
all applications and utilities have 
been merged) are 

• Archivers 

• Database 

• Patches 

• Productivity 

• Text Processing 

• Utilities 



The meanings of most of these key- 
words are also self-evident. (Isn't it nice 
when it works out that way? Thanks. Greg, 
for the hard work in finding a small set of 
good keywords.) Productivity applies to 
utilities and/or applications designed to 
improve your productivity, including menu 
systems. 

We discovered at the last minute that we 
are allowed only six primary keywords per 
topic and were forced to merge several 
keywords. The Utilities keyword is subdi- 
vided with three secondary keywords: Disk. 
Printer and System. If you want to search 
for a disk, printer or system utility, search 
using the keyword Disk. Printer or System 
instead of Utilities. However, the keywords 
used in Applications may be changed if we 
find a better solution, and all changes will 
be documented in the Forum. 

Two Meg Coming Into Vogue? 

In the OS-9 SIG Forum this month, there 
has been a fair amount of discussion by 
several SIG members who upgraded their 
CoCo's to two megabytes of memory. While 
this upgrade isn't for the weak of heart, it 
works. Details have been uploaded into the 
databases. 

ft 
Carbon Copies 

There's a new feature in Mail. Now. 
when you send, reply to or forward mail, 
you can send a carbon copy of the message 
to other people. To turn this feature on. use 



the Mail command SET 
CC_PR0MPT. (Turn it off 
using SET N0CC_PR0MPT.) 
This setting lasts until 
you change it. You can 
now use the CC : prompt 
just as you would use the 
To: prompt. For ex- 
ample, if I got a message from Jason Bucata 
that was to me, Greg Law, Tim Kientzle and 
Bob Kemper, the header would look like 
the one shown in Figure 3. 



To: 80S1A::JBUCATA 

Subj: Re: This isn't a real message 

CC: 

Figure 4: Mail Message Header on Reply- 



Remember that the B0S1 A: : part simply 
means computer 1A at Boston; you can 
ignore this part of the Mail address. If I now 
type REPLY, assuming I've turned on 
CC_PR0MPT, I will see the header shown in 
Figure 4 with the cursor waiting after the 
CC : prompt. If I now type 

CC: GREGL. TIMKIENTZLE. BOBKEMPE 
R. EDDIEKUNS 



four carbon copies of 
the message will be 
sent, one to myself. 

May Uploads 

Paul Seniura con- 
tributed an essay de- 
scribing many of the 
common grammar 
mistakes he notices in 
Forum messages and 
program documenta- 
tion. If you are con- 
cerned about your 
grammar, you may 
want to read this short 
essay. Greg Law 
posted a Forum mes- 
sage describing the 
new standards we're 
trying to establish in 
the OS-9 SIG databases. 
Paul Ward and Ed 
Gresick uploaded 
more information 
about their new OS-9/ 
68000 computers. 

Jerry Stratum's 
Corner Clock displays 
and updates the cur- 
rent time in the corner 
of the window you run 
it in; his Optsiart al- 



lows a Shell script (particularly the startup 
Shell script) to perform one of several dif- 
ferent commands, with the choice based on 
which keys are being pressed. Philip Brown 
posted the binary executable for tar. a 
commonly used archiving program; Ed 
Gresick previously contributed the source 
and documentation. Brian While released 
SPEEDISK VERSION 0.21. This useful util- 
ity defragments your disk as well as per- 
forms disk checking. The current version 
works only on small disks. Brother Jer- 
emy uploaded MVWorcl. the beginning of a 
WYSIWYG editor: an OS-9 analog to MAX-10. 

Paul Jerkatis posted Bruce Isted's 
SAC I A RS-232 driver, which is a replacement 
for AC I APAK. (This driver is also included in 
Bruce's earlier upload. ELIMINATOR SOFT- 
WARE AND MANUAL.) Marie-Louis Marcoux 
released her patch to Burke & Burke's 
hard-disk drivers to allow you to partition 
your hard drive into multiple drives. Randy 
Wilson uploaded the latest version of Su- 
percomm, which fixes some bugs from 
earlier versions and supports ZModem. John 
Farrar contributed his new TRXMon. This 
program acts like TSMon (it monitors a serial 
line, waiting for an incoming call) except 
that it detects the speed of the incoming call 
before forking Login. 

Philip Brown uploaded a sample pro- 



OS-9 Budget System 



MV Systems is proud to offer this fine Bastc09 program written by Mike Dean. More 
than just a budget program, this system allows you to track and analyze your financial 
transactions and prepare helpful reports to fit your financial needs. Runs In text or 
graphics screens. Requires Tandy Color Computer 3 or compatible computer w/2S6k, 
disk drive, and OS-9 Level 2. Multi-Vue optional Introductory price 119.951 



High Finance 



Perform a variety of financial analysis calculations and create schedules of periodic 
data with this easy to use Multi-Vue application. Intelligent financial decisions are just a 
point and click away! Includes fantastic on-line tutorials that help you leam to use the 
program quickly and easily. Includes present/future value, sinking fund, loan 
amortization, depreciation, and much more! Requires Tandy Color Computer 3 or 
compatible computer w/t28k (256k or more recommended), disk drive, mouse/joystick, 
and OS-9 Level 2 w/Windint module. Multi-Vue recommended. $24.95. 

| OS-9 Calendar Utilities | 

Ever wish you could display your schedule for the day automatically on start up? Or, 
perhaps you have wanted to perform repetitive maintenance tasks on your Gcal data 
tiles quickly and easily? Or, maybe you have given up on Gcal totally because you 
couldn't print your calendar data. MV Systems' OS-9 Calendar Utilities will handle all 
these tasks for you. and morel You can use these popular utilities as companions to 
Multi-Vue's Gcal program, or by themselves to perform many handy scheduling tasks! 
Requires Tandy Color Computer 3 or compatible computer w/128k. disk drive, and OS- 
9 Level P Multi-Vue optional Still just $14,951 

[ Special Offer! Purchase all three programsfor just $54.95! ~"| 

Software Developers: MV Systems needs quality OS-9/OSK software to market. MV 
Systems is actively Involved in helping sotware developers like you bring their products 
to market. We can help you put the finishing touches on your program or its 
documentation, if needed, and then help you market your product effectively. We can 
also assist you In porting your product between OS9 and OSK (Version 2.4). So, if you 
have written (or are writing) software you would like to market, contact us for details. 
You'll be glad you dldl 



A* products carry the Rainbow Certification Seal 

VISA and MasterCard orders accepted. 

Please add S2.50 (US J or S5.00 (foreign) tor snipping and handling to aH orders 

Colorado residents please add 3% sales tax 



MV Systems 

P.O. Box 818 
Arvada. CO 80001 

(303)420-7777 



The OS-9 and Mulli- Vuc specialists? 



gram demonstrating how to use Bruce 
Isted's VRN virtual-memory driver as well 
as a file explaining how to use subroutine 
modules. Brian McCuskee released 
CCTools, an application patterned after the 
popular PC Tools 

In the CoCo SIG. Joe Sannucci uploaded 
a file that has made the rounds on the 
networks. This file explains in detail why 
suicide shouldn't be an option. He also 
contributed two useful disk utilities, one 
that shows the files on adisk and the amount 
of free space, and another by Roger Taylor 
that gives the COPY command wildcards. 
Marty Goodman posted a forum message 
by Art Flexser describing how to custom- 
ize the setup for Extended ADOS-3. Marty 
also uploaded two text files describing 
Multi-Pak repairs. One explains why all 
Multi-Paks must be upgraded for CoCo 3 
use and the other details his repair of a dead 
Multi-Pak. 

Don Vaillancourt contributed several 
arcade games called Wizard, Space Hawk 
and Moon. Johnny Williams released 
Version 1.1 of Super Trivia with the trivia 
titled Pseudonyms. Danny Fye uploaded 
answers to this trivia. Matthew Thompson. 
the author of Bells & Whistles 2, released 19 
songs from his music library. Marty 
Goodman posted a product announcement 
by the author of CCTools. a product similar 
to PC Tools. Q 



Database Report 



OS-9 SIG 



General Information 

COMMON MISTAKES IN ENGLISH 
PAULSENIURA Paul Scniura 

NEW 68XXX NEWSLETTER 
EDELMAR Ed Gresick 

DATABASE UPDATE AND STANDARDS 
GREGL Greg Law 

MM/1 C GRAPHICS LIBRARIES 
PKW Paul K. Ward 

Applications 

PERUSE VI. 0: FILE VIEWER 
STEPHENC Stephen Casiello 

3D GRAPHICS PLOTTER 
DONTHRASH Donald Thrash 

VDG SCREEN CREATOR 
KMTHOMPSON Kelly Thompson 

GSORT REPLACEMENT 
WOAY Jim Martin 

CORNER CLOCK 

CAPVIDEO Jerry Sirallon 

OPTSTART: OPTIONAL STARTUP 
CAPVIDEO Jerry Sirauon 

ALTER BYTES IN A FILE 
CAPVIDEO Jerry Stratton 



TAR EXECUTABLE 
THEFERRET Philip Brown 

P0INT-AND-SH00T MENU 
SEBJMB Jeff Blower 

SPEEDISK V0.21 
BR1ANWHITE Brian While 

WORD WRAP TEXT FILES 
RZAKER BobZakcr 

MVWORD (WYSIWYG EDITOR) 
REVWCP Broiher Jeremy 

INDEX DISK FILES 
RZAKER BobZaker 

Device Drivers 

REPLACEMENT FOR ACIAPAK 
MITHELEN Paul Jerkalis 

B&B HARD DISK PARTITION 
MARLOU Marie-Louis Marcoux 

Telcom 

SUPERCOMM VERSION 2.1A 

RANDYKWILSON Randy Wilson 

RIBBS 2.0 STUFF 

WESGALE Wes Gale 

TRXMON TEST VERSION 

TRIX John Farrar 

Graphics & Music 

MFF10: HANDLES LARGER MFF1 FILES 
PAULSENIURA Paul Seniura 

THE LEGEND 

BOBKEMPER Robert Kemper 

3 PLAYBOY PLAYMATES MACPIX 
GRAPHICSPUB Bob Montowski 

3 PIX OF PLAYMATE RENEE TENISON 
GRAPHICSPUB Bob Montowski 

PLOT QUADRATIC EQUATIONS 
MIKEHAN Mike Hanewinckcl 

IVES'S FOURTH SYMPHONY 
DMACIAS David Macias 

MAGIC STONES GAME 
RESLER Floyd Reslcr 

RESCUE THE COLONISTS! 
RESLER Floyd Resler 

THE DUNGEON DEPTHS 
RESLER Floyd Resler 

LIFECALL ADVERTISEMENT SOUNDS 
KENCARLIN Ken Carlin 

Programmers Den 

TEXT-SCREEN MOUSE CURSOR 

THEFERRET Philip Brown 

CC2 PATCH 

WESGALE Wes Gale 

GFX3 AND DOC 

MIKEHAN Mike Hancwinckel 

C MEMORY MAPPING LIBRARY 

DONTHRASH Donald Thrash 

VRN ALLOCATION DEMO 

THEFERRET Philip Brown 

SUBROUTINE MODULES & HOW TO USE 

THEFERRET Philip Brown 

CTAGS - INDEX C SOURCE FILES 

THEFERRET Philip Brown 

CCTOOLS 

BEMCCUSKEE Brian McCuskee 

SAVE AND RESTORE WINDOW INFO 

ZACKSESSIONS Zack Sessions 



COCO SIG 



General Information 

SUICIDE? YOU GOTTA BE KIDDING! 
SANNUCCI Joe Sannucci 

CoCo 3 Graphics 

SUPERMAC * 

SANNUCCI Joe Sannucci 

PAULA ABDUL PORTRAIT 

SANNUCCI Joe Sannucci 

KEEBLER'S N0.1 ELF 

HOWARDC Howard C. Rouse 

GRAVE2.CM3 

HOWARDC Howard C. Rouse 

MATADOR & T0R0 THE BULL 

HOWARDC Howard C. Rouse 

HUMMING-BIRDS 

HOWARDC Howard C. Rouse 

GREAT PLAYMATE SEARCH 

LDMOORE Larry Moorc 

NIB NUBILES #5 (19 PICS) 

STEVEPDX Steve Rickctts 

NIB NUBILES #3 (16 PICS) 

STEVEPDX Steve Ricketts 

NIB NUBILES #4 (22 PICS) 

STEVEPDX Steve Ricketts 

THE PROJECTOR 

SAGAN John McCaffrev 

NIB NUBILES #1 (17 PICS) 

STEVEPDX Steve Ricketts 

NIB NUBILES #2 (18 PICS) 

STEVEPDX Steve Ricketts 

Utilities & Applications 

DISK DIRECTORY-FREE GRANS VIEWER 
SANNUCCI Joe Sannucci 

WILDCOPY 

SANNUCCI Joe Sannucci 

CHECKBOOK FOR COMPOSIT MONITORS 
COCKYFS Fred Swygcrt 

HIGHLIGHT FIX 4 AD0S3 
MARTYGOODMAN Marty Goodman 

Hardware Hacking 

WHY THE MULTIPAK MUST BE UPGRADE 
MARTYGOODMAN Marly Goodman 
A REPAIR OF A MULTIPAK 
MARTYGOODMAN Many Goodman 

Games 

ANSWERS FOR SUPER TRIVIA 1.1 
DFYE Danny Fye 

HI -RES CHESS BOARD SIMULATOR 
DRILLMASTER Johnny Williams 

ARCADE PACK 

DONVAIL Don Vaillancourt 

SUPER TRIVIA 1.1 
DRILLMASTER Johnny Williams 

Music & Sound 

BOB'S ASSORTED LYRA MUSIC 
BAWILLIAMS Bob Williams 

19 BW2 SONGS 
MATHOMPSON Maithew Thompson 

Product Reviews & Announcement 

COCO TOOLS FROM CER COMP 
MARTYGOODMAN Marly Goodman 
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SYSTEM IV 

The 68000 Computer serving customers here and abroad 



THE BEST OF ALL WORLDS 
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08-9 Power - outperform!) other machines 
in its' price class 

A MulU-Dser Multi-Tasking System 

Versatile - runs 08-9/68000, STARDOS, 
REXD0X, MS-DOS and other 
Operating Systems 

Flexible - tailor to your requirements 

Expanrlahle using readily availahle 
Low-cost Cards 

Optional Plug-in Board for MS-DOS 

Optional Emulator /Interpreter for 
OS-9/6809 Software 

Ideal low-COSt development platform 

Prices start at $999.00 



For Kits and Assembled Boards call Peripheral Technology at 404-984-0742 
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OS9/68000 SOFTWARE 



M6809 - 6809 Emulator /Interpreter $99.95 
M6809 emulates the user mode OS9 Level II binary object 
modules under OS9/6800Q. 



QUICK ED - Screen Editor and Text Formatter $275.00 
A high quality documentation tool and program editor 
ideally suited to laser printer users. Uses function and 
cursor keys on any terminal, configurable per user. 
Micro-Justifies mixed proportional text Automatic table 
of contents generation and user-definable macros and 
commands. Handles an unlimited number of fonts. Drives 
any printer. Ideal for multi-user systems. Available on a 
30-day trial. 



DISASM.OS-9 - OS-9/68K DLsassemhler 3250.00 

This high-speed, three-pass 68000 disassembler can also handle 
the 68010 and 68020. It intelligently decodes module 
headers and produces syuihol information that rau he 
repeatrdly edited and passed through the disassembler 
allowing iterative disassembly. The system libraries are read 
to supply symbols. 



FLEXELINT V4.00 - C Source Code Checker $495.00 
Flexelint finds quirks, idiosyncracies, glitches and bugs in 
C programs. 60 options control checking by symbol name 
or error number. Checks include intermodule incon- 
sistencies, definitions and use of variables, structures, 
unions and arrays, indentation, case fall-through, type 
conversion, printf and scanf format string inconsistencies 
and suspicious semi-colons. A must for all serious C 
programmers. 



WINDOWS - C Source Code Windowing Library $250.00 
This C source code library package supports multiple over- 
lapping windows displayed ou one character-based terminal 
screen. It supports window headers and footers, and popup 
windows. Windows may be moved, panned, written to while 
off -screen, etc- 



PROFILE - User Stale Program Profiler $270.00 

Designed to profile user-state programs. Profile effectively 
samples a traced execution building statiscal information as il 
goes. It reads symbol table modules to give a func- 
tion-by -function account of the time spent during execution. 
The user may "zoom-in" ou a function to find a smaller range 
of addresses where time is being spent. 
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Middletown Plaza - PO Box 78 - Middletown, DE 19709 
302-37&2555 FAX 302-37&2556 
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EPROM Programmer, Too 



by Tony DiStefano 

Contributing Editor 



I started a four-part series on building 
an EPROM programmer in the August 
1990 issue of THE RAINBOW. This 
programmer was originally a Disto 
product I introduced in early 19X5. 
When I designed hardware back then. I 
didn't have the fancy CAD (Computer-As- 
sisted Design) software and hardware 1 
now use to design things. Back then, every- 
thing was done by hand, on sheets of paper. 
When I transferred all my work on the 
EPROM programmer from my scribbled 
notes to articles for THE RAINBOW, some 
errors crept in. When you work with Hi- 
Tech toys, it is very easy to create CAE 
(Computer-Assisted Errors). 

A reader from Texas was kind enough to 
make note of these errors and tell me about 
them. He was able to get the EPROM pro- 
grammer working, but 1 feel 1 should pass 
The information along to you in case you 
tried to get the EPROM programmer work- 
ing and got stuck. Another reader wrote 
asking if he could have a copy of the assem- 
bly-language source code so he could make 
changes to the EPROM programmer soft- 
ware. Other readers also indicated their 
interest in programming EPROMs with larger 
capacity. Let's take a look at each these 
three topics. 

Corrections 

Here are the corrections to the EPROM 
programmer series. The first has to do with 
U8, the V pp voltage regulator. This problem 
stemmed from using a replacement part. In 



Tony DiStefano is a well-known early spe- 
cialist in computer hardware projects. He 
lives in Laval Ouest. Quebec. Tony's user- 
name on Delphi is DISTO. 



the original EPROM programmer. 1 used a 
78GUIC voltage regulator. This part is no 
longer available so I used the LM3I7 as a 
replacement, but the LM317 is not com- 
pletely compatible with the 78GU1C Remove 
R4. R5, R9 and JP2. Add a 220-ohm resistor 
from Pin 1 to Pin 2 of U8. Add a 3.3K-ohm 
resistor from Pin 1 of U8 to Ground. This 
gives you 21 volts. Add a lOOK-ohm resistor 
from Pin I of us to the first pin of a 2-pin 
jumper. Add a wire from the second pin of 
the jumper to Ground. When the jumper is 
installed, the output voltage should be 12.5 
volts. 

The last word of the second sentence of 
the fourth paragraph of the second column 
on Page 68 of the September I wo issue 
should be Low. The last word of the sixth 
sentence of the same paragraph should be 
High. In the sixth sentence of the third 
paragraph of the same page, the word Low 
should be High and the word High should 
say Low. Finally, the inputs and outputs of 
Ul have been drawn in reverse. To correct 
this, you have to swap eight pairs of wires. 
Swap pins 2 and 1 8, 4 and 16, 6 and 14. sand 
12. 1 1 and 9. 13 and 7. 15 and 5, and finally 17 
and 3. With these alterations, the EPROM 
programmer should work properly. 

Source Code 

Listing 1 shows the assembly-language 
source code I used to run the EPROM pro- 
grammer. To assemble this into an execut- 
able program. 1 used the Macro-XOC assem- 
bler from Micro Works. Other assemblers 
may work as well, but you may have to 
make minor changes to the source code. 
The source code also has comments, which 
are essential to understanding the inner 
workings of the program. Everyone has 
different ways of commenting source code. 

If you plan to change the source code 



and you don't understand a section of code, 
you have to go through the instructions one 
at a time. I find that you must know your 
computer hardware very well before you 
play with source code that controls hard- 
ware. I am including the source code for 
those of you that understand hardware and 
software very well and may want to change 
things around or play with larger capacity 
EPROMs. But. be careful in what you do. 
Remember, when dealing with hardware, it 
is very easy to burn something out, includ- 
ing your computer. 

Modifications 

The following ideas about programming 
larger EPROMs are only theories and guide- 
lines. In order to make this work, you must 
do more detailed work and prototypes. This 
is not a complete and tested project. 

Figure 1 shows four large EPROMs. Each 
one has double the capacity of the previous. 
The first, a 27256. is a 32K EPROM. The others 
are64K. 1 2XK and 256K. respectively. I know 
there is another EPROM on the market al- 
ready that has a capacity of 5I2K. The part 
number is 27040 but I could not find a 
diagram for it. My guess is that the 'PGM pin 
becomes ais. 

The first EPROM (the 27256) is in a 28-pin 
package. It already works in our program- 
mer. 1 put it on this list to make pin compari- 
sons. The second is also in a 28-pin package. 
As you can see. the only difference between 
the two is Pin 1. What was V p| , is now A15 
and V™ is moved to Pin 22. This technique 
has been used before. Remember the 24-pin. 
8K EPROM by Motorola? It used *CE as V pp . 
The 27010 and 27020 EPROMs are slightly 
larger packages. There are 32 pins on these 
parts. The extra pins are used for more 
address control lines. Things seem to repeat 
themselves. The 27010 and the 27020 have 
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Figure I 



the same control signals as the 27128. 
Namely, *CE, 'OE, V p| , and *PGM. The only 
logical difference is the number of address 
lines. The physical difference is the number 
of pins per package. So. in theory, the only 
difference to program the 27010 is that it is 
larger (in the number of memory bytes it 
has). All the waveforms will be the same. 
To someone who wanted to program these 
larger EPROMs. here are the changes to 
consider. 

The first problem to overcome is the 
bigger eprom socket. You need a 32-pin 
socket. If you look carefully, starting from 
Pin 5 of the 27010 and Pin 3 of the 27I2X. all 



the signals are the same almost all the way 
around. Only minor changes are needed. 
Wiring the balance of the signals requires 
that you match the signals from one socket 
to the other. The next problem is the extra 
address lines. You will need another latch 
to add the extra lines. This means using 
another 74LS138 and another 74LS273. Use 
the other half of A2 to memory-map the 
extra locations. 

The final problem you have to deal with 
is software. You need to edit the EPROM 
programmer software to consider the extra 
address lines and the extra memory re- 
quired to load and save the extra data re- 



quired to fully program a 27010. Remember, 
it is a I2SK EPROM. If you only have a CoCo 
I or 2. you need to transfer data in small 
blocks. If you have a CoCo 3 with 5 1 2K. you 
have to learn how the memory paging works. 

Now. when all is said and done, some 
EPROM manufacturers state that the 27010 
and 27020 have the option to be programmed 
using a quick-pulse method. This can save 
much time in programming. This method is 
different than the one 1 use. An EPROM data 
manual will describe how it is done. 

I leave it up to you to design the circuit 
and the support software. Good luck in 
programming bigger EPROMs. J 





32K Disk 


* 












The Listing: EPROM. ASM 










* THIS 


IS A DISTO EPROM 




LBSR 


OUTLIN 




* PROGRAMER. 






LDU 


#CONTRL 




* LAST 


VERSION 


MAY 06 90 




LBSR 


GETCHR 




* LAST 


CHANGE 


FOR CMOS EPROMS 




STA 
CMPA 


IDENT 

n 




CLS 


EQll 


$A928 




BEO 


ST2 




CONTRL 


EOU 


$FF51 




CMPA 


#•2 


DELAY 


EQU 


$006F 




BEQ 


ST4 




DSTART 


EQU 


$3000 




CMPA 


#•3 




CURPOS 


EOU 


$88 




BEQ 


ST4 




LENGTH 


EQU 


$380 




CMPA 


#■4 




X 


EOU ' 


$382 




BNE 


ST1 




ERRFLG 


EOU 


$383 


ST4 


LDD 


#$4000 




PADD 


EOU 


$384 




BRA 


ST3 




DEND 


EOU 


$386 


ST2 


LDD 


#$2000 




TEMP 


EOU 


$388 


ST3 


STD 


LENGTH 




IDENT 


EOU 


$389 




ADDD 


#DSTART 




INBUF 


EOU 


$2DD 




STD 


DEND 




LINEIN 


EQU % 


$A390 
















WAR1 


LBSR 


PPAGE 


PRINT TITLE PAGE 


START 


CLR 


$FF40 












ORCC 


#$50 MASK INT 


WARM 


LDY 


m 


CLEAR ADDRESS 


ST1 


JSR 


CLS 




CLR 


0.U 


SHUT DOWN EPROM 




LEAX 


TITLE. PCR 




CLR 


2.U 


ZERO STEPPER 
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CLR 


ERRFLG 




SOUND 


CLRB 








LDA 


#$D0 






STA 


$8C 






LDX 


#00 






STX 


$8D 




SOI 


JSR 
INCB 


$A962 


MAKE SOUND 




BNE 


SOI 




WA1 


LDX 


#$S4A 






STX 


CURPOS 




WA2 


LBSR 


GETCHR 






CMPA 


#'0 






BGT 


WA3 






BRA 


WA2 




WA3 


CMPA 


#"6 






BGT 


WA2 






JSR 


[$A002] 






PSHS 


A.X 






LEAX 


BLANK. PCR 






LBSR 


STATL 






PULS 


A.X 






CMPA 


#'1 






BEO 


ERASED 






CMPA 


if 2 






LBEO 


PROG 






CMPA 


#'3 






LBEQ 


VERIFY 






CMPA 


#'4 






LBEO 


MOVE 






CMPA 


#•5 






BEO 


FINI 






CMPA 


#'6 






LBEQ 


EXAM 






BEQ 


WA1 




FINI 


LBRA 


$A027 


END OF LINE! 


ERASED 


LEAX 


CHECK. PCR 


MESSAGE 




LBSR 


STATL 


PRINT 




LDX 


#DSTART 


START OF MEM 




LBSR 


ONREAD 






LDA 


#$FF 




ER1 


CMPX 


DEND 






LBEO 


POK 


PRINT OK AND WARM 




CMPA 


-l.U 






BEO 


ER2 






LEAX 


l.X 






LBSR 


ERROR 






LEAX 


l.X 




ER2 


LBSR 


INCADD 






LEAX 


l.X 






BRA 


ER1 




MOVE 


LEAX 


TRANS. PCR 






LBSR 


STATL 






LDX 


#DSTART 






LBSR 


ONREAD 




MOl 


LDA 


-l.U 


EPROM DATA 




STA 


.X+ 


IN MEMORY 




CMPX 


DEND 






BEQ 


M04 






LBSR 


INCADD 






BRA 


MOl 




M04 


LBRA 


POK 




EXAM 


LEAX 


EXMEG.PCR 






LBSR 


STATL 






LDB 


#4 


4 CHARACTERS 


A@ 


LBSR 


LINEIN 






LBCS 


BREAK 






LDX 


#INBUF 






LBSR 


GNUM 




E@ 


LDA 


w 






JSR 


[$A002] 






TFR 


X.D 






LBSR 


HEXASC 
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TFR 


B.A 




LBSR 


HEXASC 




LDA 


#$20 




JSR 


[$A002] 




LDA 


.X 




LBSR 


HEXASC 




LDA 


#$20 




JSR 


[$A002] 




CLR 


TEMP 


r@ 


LBSR 


GETCHR 




CMPA 


#94 




BEQ 


B@ 




CMPA 


#10 




BEQ 


C@ 




CMPA 


#$D 




LBEQ 


WAR1 




CMPA 


#'0 




BLO 


F@ 




CMPA 


#•9 




BLS 


Q@ 




CMPA 


#'A 




BLO 


F@ 




CMPA 


#'F 




BHI 


F@ 


Q@ 


STA 


INBUF 




JSR 


[$A002] 


Rg 


LBSR 


GETCHR 




CMPA 


#"0 




BLO 


R@ 




CMPA 


#•9 




BLS 


S@ 




CMPA 


#'A 




BLO 


R@ 




CMPA 


#'F 




BHI 


R@ 


S@ 


STA 


INBUF+1 




JSR 


t$A002] 




CLR 


INBUF+2 




PSHS 


X 




LDX 


#INBUF 




LBSR 


GNUM 




TFR 


X.D 




TFR 


B.A 




PULS 


X 




STA 


.X+ 




LBRA 


E@ 


B@ 


LEAX 


-l.X 




LBRA 


E@ 


C@ 


LEAX 


l.X 




LBRA 


E@ 



UP ARROW 
DOWN ARROW 



FIRST DIGIT 
SECOND DIGIT 



This is the routine to program 

the EPROM. 

It starts up by: 

A12 & A13 TO 

VCC ON (HI) 

VPP OFF (LO) 

PGM & OE DISABLED (HI) 

WDE INABLED (HI) 

CE INABLED (LO) 



PROG 


LDA 


IDENT 






CMPA 


ff'2 






L8GT 


PROGS 






LEAX 


PEPROM.PCR 






LBSR 


STATL 






LDX 


#DSTART 






LDB 


#%1 1001 100 


START UP 




STB 


.U 






LDA 


.X+ 


FIRST BYTE 




STA 


-l.U 


TO EPROM 




ORB 


#$20 


VPP ON 




STB 


.U 




PGM1 


CLR 


X 


COUNTER PROG LOOP 


PGM2 


LDA 


#1 






LBSR 


PAMS 


BURN FOR 1 ms. 




INC 


X 





LDA 


X 


CMPA 


#15 


BEO 


LBURN 


ANDB 


#%01111011 


STB 


,U 


LDA 


-l.U 


ORB 


#210000100 


STB 


.u 


CMPA 


-l.X 


BNE 


PGM2 


LBURN LDA 


X 


ASLA 




ASLA 




LBSR 


PAMS 


PSHS 


D.X 


STX 


PADD 


LOX 


CURPOS 


LBSR 


OUTADD 


LDA 


#$20 


JSR 


[$A002] 


LDA 


X 


LDB 


#5 


MUL 




TFR 


B.A 


LBSR 


HEXASC 


STX 


CURPOS 


PULS 


D.X 


LDA 


X 


CMPA 


#15 


BNE 


LADDR 


ANDB 


#%01111011 


STB 


.U 


LDA 


-l.U 


ORB 


#%10000100 


STB 


.U 


CMPA 


-l.X 


LBNE 


FAILED 


LADDR CMPX 


DEND 


LBEO 


POFF 


LBSR 


INCADD 


LDA 


,X+ 


STA 


-l.U 


LBSR 


BREAK 


BRA 


PGM1 



READ MODE 

GET DATA 
WRITE MODE 

PROGRAM? 

NO ANOTHER SHOT 



MULTIPLY BY 4 
BURN A MS 



READ MODE 

GET DATA 
WRITE MODE 



FINISHED 

NEXT EPROM ADD 

GET NEXT DATA BYTE 

CHECK BREAK KEY 
BURN AGAIN 



UH1S IS THE ROUTINE TO PROGRAME 
*THE 27256 BOTH HIGH AND LOW 



PROGS 


LEAX 


PEPROM.PCR 




LBSR 


STATL 




LDX 


#DSTART 




LDA 


IDENT 




CMPA 


#'3 




BEQ 


PR1 




LDB 


#%11011100 




BRA 


PR2 


PR1 


LDB 


#%1 1010100 


PR2 


STB 


.U 




LDA 


;x+ 




STA 


-l.U 




ORB 


#$20 




STB 


.U 


PGM1S 


CLR 


X 


PGM2S 


LDA 


#1 




LBSR 


PAMSS 




INC 


i 




LDA 


X 




CMPA 


#15 




BEQ 


LBURNS 




ANDB 


#%01111011 




STB 


.U 



START UP 2/2 

START UP 1/2 

FIRST BYTE 
TO EPROM 
VPP ON 

COUNTER PROG LOOP 

BURN FOR 1 ms. 



READ MODE 



LDA 


-l.U 


ORB 


#%10000100 


STB 


.u 


CMPA 


-l.X 


BNE 


PGM2S 


LBURNS LDA 


X 


ASLA 




ASLA 




LBSR 


PAMSS 


PSHS 


D.X 


STX 


PADD 


LDX 


CURPOS 


LBSR 


OUTADD 


LDA 


#$20 


JSR 


[$A002] 


LDA 


X 


LDB 


#5 


MUL 




TFR 


B.A 


LBSR 


HEXASC 


STX 


CURPOS 


PULS 


D.X 


LDA 


X 


CMPA 


#15 


BNE 


LADDRS 


ANDB 


#%01 111011 


STB 


.U 


LDA 


-l.U 


ORB 


#% 10000 100 


STB 


.U 


CMPA 


-l.X 


LBNE 


FAILED 


LADDRS CMPX 


DEND 



GET DATA 
WRITE MOOE 

PROGRAM? 

NO ANOTHER SHOT 



MULTIPLY BY 4 
BURN A MS 



READ MODE 

GET DATA 

WRITE MODE 



SALE! Buy Now At Lowest Prices. 



BANKMAN . Continuously updates your checkbook. Save, Edit 
and print tiles. Lets you analyze spending; reconciles, sum- 
marizes banking transactions. Uses 32K. Manual. . . $29.95 
CHECK WRITER . Uses your printer and standard bank checks to 
help handle your accounts. Saves files, reloads, edits and 
pauses printer to let you write in amounts. Manual. . $19.95 
GENERAL STATISTICS. Computes over 50 stats, including 
Standard deviation & error, Covariance, Correlation, Chi- 
Square and ANOVA. Includes screen tables and manual. Edits, 
Saves and Prints data. User friendly. Has Manual. . . $29.95 
ENVELOPE WRITER. Prints return and mailing addresses dir- 
ectly on the envelope with a DWP or on tractor envelopes with 
a DMP. Saves on labels! Memorizes return addresses. Prints 
with custom fonts on TANDY printers. Uses 16K. . . . $17.95 
BASEBALL STATS . Keeps track of 20 statistics. Continuously 
updates. Full of options! Uses 32K. Includes Manual. $29.95 
QUICK STATS . A Baseball Scoreboard! Keeps track of over a 
dozen stats. Lets you save, edit and print out data. . . $22.95 
BALL CARDS . A database for baseball card collectors. .$19.95 
BRAINBUSTERS . Multiple ChoicefTrue-False Test Writing 
program. Lets you Save, Edit, Select, Randomize & Print. 
Many more options! Use professionally or for fun. . . $29.95 
THE EXAMINER . Use with above program to take "On Screen" 
tests. Grades and Saves results. For home or class. . . $19.95 
TRIVIA 1-3 . Try these BRAINBUSTER quizzes. Each. . . $5.95 
INVENTORY MANAGER from Forrest Enterprises. Writes in- 
voices, keeps track of stock, saves time & money. . . .$24.95 
COCO LABELS . Prints fancy fonts w/TANDY printers. Select 
names from alphabetical screen index. Prints dups. . $19.95 
CALCULATOR . One of a kind. Prints out! Simulates adding 
machine. All standard functions plus 7 memory banks. Si4. 95 



Specify COCO 1, 2 or 3. 
Disk Only. Send check or 
money order. Add $3.00 
Shipping/Handling. In 
IL add 6.25% Sales Tax. 



TRADING POST 



DISTRIBUTORS OF ^(Jj 
5-STAR SOFTWARE 
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BEQ 

LBSR 

LDA 

STA 

LBSR 

BRA 



POFF 

INCADD 

.X+ 

-l.U 

BREAK 

PGM1S 



POWER DOWN WITHOUT FALSE 
BURN OF CMOS DEVICES 



POFF 



LDA 

STA 

ANDB 

STB 

LBRA 



#$FF 
-l.U 
ff%l 1011111 

.U 
POK 



* This routine verifies EPROM. 



VERIFY LEAX 
LBSR 
LDX 
LBSR 
LDA 
CMPA 
BEQ 
LBSR 
CMPX 
BEO 
LBSR 
BRA 

VEREND LBRA 



VER1 



VER2 



VEPROM.PCR 

STATL 

#DSTART 

ONREAD 

.X+ 

-l.U 

VER2 

ERROR 

DEND 

VEREND 

INCADD 

VER1 

POK 



* START OF ROUTINES 



INCADD 



INC1 



PAMS 



PA2 
PA1 



LEAY 

CMPY 

BNE 

LDY 

INCB 

STB 

CLR 

RTS 

PSHS 

ANDB 

STB 

LDX 

LEAX 

BNE 

DEC 

BNE 

ORB 

STB 

PULS 

PSHS 

ANDB 

STB 

LDX 

LEAX 

BNE 

DEC 

BNE 

ORB 

STB 

PULS 



FAILED CLR 
CLR 
STX 
LEAX 
LBSR 
LBSR 
LBRA 

STATL PSHS 
LDX 



PAMSS 



PA2S 
PAIS 



l.Y 

#$10t 

INC1 

#0 
.u 

l.U 



#%m 101 11 
.u 

#DELAY 

-l.X 

PA1 

A 

PA2 

#%0001000 

.U 

X.PC 



#5611101111 

■ U 

#DELAY 

-l.X 

PAIS 

A 

PA2S 

#%00010000 

.U 

X.PC 

2.U 

.U 

PADD 

PFAIL.PCR 

STATL 

OUTADD 

WARM 



FINISHED 

NEXT EPROM ADD 

GET NEXT DATA BYTE 

CHECK BREAK KEY 
BURN AGAIN 



(NO ERASING) 
STORE DATA 
TURN VPP OFF 
DO IT 
FINISHED BURN 



MEMORY DATA 
EPROM DATA 



INC STEPPER 



CLEAR STEPPER 
NEXT ADDRESS BLOCK 

STEP INC ADDRESS 



PGM ON (LOW) 
3 CYCLES 
8 CYCLES 
PER LOOP 

2 CYCLES 

3 CYCLES 

PGM OFF (HI) 



CE ON (LOW) 
3 CYCLES 
8 CYCLES 
PER LOOP 

2 CYCLES 

3 CYCLES 

PGM OFF (HI) 



STEPPER 

SHUT DOWN EPROM 





STX 


CURPOS 




PULS 


X 


OUTLIN 


PSHS 


A.X 


OUT1 


LDA 


.X+ 




CMPA 


#4 




BEO 


OUTEND 




JSR 


[$A002] 




BRA 


OUT1 


OUTEND 


PULS 


A. X.PC 


PPAGE 


PSHS 


A.X.Y 




JSR 


CLS 




LEAX 


SEL.PCR 




BSR 


OUTLIN 




LDA 


IDENT 




CMPA 


#•1 




BEQ 


PI 




CMPA 


if 2 




BEO 


P2 




CMPA 


#•3 




BEQ 


P3 




LEAX 


E2562.PCR 




BRA 


PF 


PI 


LEAX 


E64.PCR 




BRA 


PF 


P2 


LEAX 


E128.PCR 




BRA 


PF 


P3 


LEAX 


E2561.PCR 


PF 


BSR 


OUTLIN 




LEAX 


PAGE.PCR 




BSR 


OUTLIN 




PULS 


A.X.Y. PC 


GETCHR 


PSHS 


B.X 


GET1 


JSR 


[$A000] 




BNE 


GET3 




DEC 


$94 




BNE 


GET5 




LDB 


#11 




STB 


$94 




LDX 


CURPOS 




LDA 


.X 




ADDA 


#$10 




ORA 


#$8F 




STA 


.X 


GET5 


LDX 


#$045 E 




JSR 


$A7D3 




BRA 


GET1 


GET3 


LDB 


#$20 




STB 


[CURPOS] 




PULS 


B.X. PC 



END OF LINE 
PRINT CHAR 



BLINK DELAY 
NOT TIME 

RESET COUNTER 
GET POSITION 
GET CHAR 
NEXT COLOR 
SOLID COLOR 
TO SCREEN 

WAIT LOOP 



ERROR PRINTS OUT 2 VALUES 

FIRST IS IN A REG 

SECOND IS POINTED TO BY U REG 



ERROR 



STATUS LINE 



STB 

PSHS 

STX 

LEAX 

LBSR 

LBSR 

LEAX 

LBSR 

LBSR 

LEAX 

LBSR 

LDA 

LBSR 

LBSR 

PULS 



OUTADD PSHS 
LDX 



#( 13*32 )+3+1024 



LEAX 

TFR 

SUBD 



ERRFLG 

D.X 

PADD 

AT.PCR 

STATL 

OUTADD 

EXP.PCR 

OUTLIN 

HEXASC 

FOU.PCR 

OUTLIN 

-l.U 

HEXASC 

BREAK 

D.X. PC 

D.X 
PADD 
-l.X 
X.D 

#DSTART 



CHECK FOR BREAK KEY 
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Bright Idea: Order some o£ these CoCo programs today! 




ISSUE m. AUGUST 1M6 

F1JPPY TUTORIAL 

RF.CIPE/MF.AUGROCERY 

DUNGEON MAZE 

SNOW SKI 

HOT lAAD 

SHIP WAR 

ERROR TRAP 

SPACFWAR3 

MAZE MASTER 3 

lamuiaoia 



ISSUE too, SEPT.. 1990 

IDEA TREE 

MASTER'S LABYRINTH 

MORSE CODE 

TEI.ES ALE CONTACTS 

PROMISED LAND QUIZ 

PROPOSAL WRITER 

AI JHABET SCRAMBLE 3 

MAGIC PUMPKIN 

DR. WHO.' P ART 4 



ISSUE »100. OCT. 1990 
ZOT MIND GAME 
SUPER TEXT EDITOR 
SUPER TEXT FORMATTER 
TURTLE SEARCH.' 
COAST TO COAST 
EASY BASIC .' 
DRAGON ADVENTURE 
WRITE OUT OTILrTY 



ISSUE 41101. NOV. 1990 ISSUE 4102. DEC. 1990 
GOSSIP REAL ESTATE ANALYSIS 

COST ESTIMATOR COCO PAYROLL 

SALO INVENTORY DR. STRANGE ADV. 

PERSONAL STATISTICIAN TANNING SALON 
AIAIX-3 TREASURE HUNT 

DEATH HUNT RIVERBOAT BTACKJACK 

5I3K RAM CATALOGER .' TURTLE RACE .' 
Bingo Caller 3 SUPER SCREEN DUMP 

~,D REMAP 



ISSUE "103, JAN. 1991 
FAMOUS PEOPLE 
LABRYNTH 3 
DATA ANALYSIS 
MEDICAL FILE 
WORD GENERATOR .' 
PRIVATE EYE ADV. 
HEARTS .1 
COCOJOKESTER 
TT.TRAPAK 3 

imiM,:mmt 



ISSUE4I04, FEB. 1991 
WINE CELLAR 
BOMB RUN 
SPLIT/APPEND FILES 
INITIALIZE 35 » 
PIG OUT 
CRYPTOGRAM 3 
GHOST HUNTER 
M-COPY 



ISSUE 4105, MARCH 1991 

ROBOCROOK 

CREDrrCARDACCT. 

ABCS ' I2JS 

ANTIQUE COLLECTOR 

FOUR SCORE 

QUICK TAX 

HI-LOAD 

QUAD EDUCATION 3 

SMURF QUEST .1 



ISSUE 4106, APRIL, 1991 
STOCK PORTFOLIO 
THE BARREL 
SERVICE MANAGER 
CROSUMS PUZZLE 
DIAMOND QUEST 
JOB SKILLS 
JOB APPLICANT 
ELDUS 3 
HRI-AK-IN'PAKI ■' 



ISSUE 4107, MAY. 1991 
DESERT STORM 
BUSSINESS PLAN 
ULTIMATE RULER 
MATH DERBY 
BLOOD PRESS..' 
COBRA ATTACK 
MONOGRAM 
COUNTRY CLUB 
SI Kll N BIANK ER 
KM-XMim 



issue aim, june. 1991 

SOUND GF.NERATER 
HIDE DIRECTORY 
LOST TREASURE 
CLUB REGISTER 
SNACK SHACK 
CIVIL WAR .1 
SPELLING QUIZ 
COCO .1 CLOWN 
QUICK ' 



ISSUE 4109.JULY. 1991 
DESTINATION UNKNOWN 
FAX COVF.RSHF.ET 
FISHERMAN S QUIZ 
BETTINa ODDS 3 
COCO .' CHESS 2 
TV SCRABBLE 
FORM LETTER 
DIVIDING FRACTIONS 
KEYBOARD PROTECT 

minimum 



RAINBOW 

CERTIFICATION 
BEAL 



Last 12 issues shown here! 



Tom Mix Arcade Games 



Get Seme cf these Public 
I < ii i<tin tee! 



Music 1-7 

Ml - 8 Utilities & 8 Songs 

M2- 17 Musico Files 

MS- 16 Musico Files 

M4- 16 Musico Files 

MS - 25 Orchestra Files 

M6 - 23 . Din Files irmly to ploy 

M7 - 23 .Bin Files reody to ploy 

Graphics 1-14 

GRI - Roinilrop. Celtic. Space * 
GR2 - Donald, Snoopy, Worldmap, 
GR.3 - 9 Coco 3 Graphic programs. 
GR4 - 22 Coco MM Pictures 
GR5 - 22 Coco Mn Pictures 
GR6 - 22 Coco Max Pictures 
GR7 ■ 15 Coco Max Pictures 
GR8 - 22 .DIN Pictures 
GR9 - 22 .BIN Pictures 
GRI0- 14 Large BIN Pictures 
GRI I - 8 MGF Pictures 
GRI 2 - Coco Max 3 Pictures 
GRI.3 - Mocpainl Graphic Fdilor 
GRI 4 - 5 Macintosh Pictures 



Adventures 1,2 

A I - CIA. Deoth Ship. Gargoyle, Kingdom, Kingtut 

• Odeysey, Nuclear Sub, Wcrewand. Willsntlv 
A2 - Andrea Doria, Curse. Ghostship, Hogjowl 

- Iccwar. Quest. Sorcerer, Survival. Adv. Gen. 



Telecommunications 1-3 

Tl - Haysae, Kermit, Mikeyterm. Teleterm 

T2 - Cobbs BBs Terminal Package 

T3 - Gcterm Communications 

Education 1-4 

E I - 12 Programs for young kids. 

E2 • 12 Programs for High School Kids 

F.3 - 1 1 Programs Teach the Coco's Commands 

E4 - 5 Graphic Programs About Australia 

HOME MANAGEMENT 1-4 

* 12 Programs Each Disk/Tope 
H I - Chkbook. Wrdproc, Typing Tutor. « 
H2 - Check. Last Will, Word Processor. * 
H.3 - Envelope, Life, Finance, Interest Role, ♦ 
H4 - Speeling Fix, Spelling Checker, + 



Ulitlltes 1-8 

*12 Programs Eoch, U1-TJ4 Require Disk* 

V I - 1 05DT, Disk Zoppcr, Rom Copy, Basic Map, ♦ 

U2 - Backup, Disktest, Customize, Offset, Bockdir. * 

U3 - Convert, Disk Library, C64pic, Relocate, + 

L'4 - Bin>Basic, Disk Master, I'narc, Zap. Unlock, ♦ 

US - Assembler, Basic 64, 51x34. Recover, * 

06 - 64 Look, HGR Color, LUST 32, Recover, ♦ 

U7 - Letter head print with 30 mini pictures 

U8 - Fig Forth language with tutorials! 



GAMES III 

*Eoch Disk/Tape Contains 1 2 Programs * 
GA I - Blockhox, Poker, Robodicc, Starrrck » 
GA2 - Amazing, Rider, Rubic, Vapor worm, * 
GA3 - Backgammon, Gremlin. Python, Robots ♦ 
GA4 -Hawks, Lunar World, Saucer, Shootem. » 
GAS - Battleship. Chicken, Raceway. Lizer. + 
GA6 - Kings Army, Novyguns, Shipsub, Shuffle, ♦ 
GA7 - Connect 4, F- 16. PiMa. Rubic. Ijfe » 
GA8 - Football, Germ Attack, Othello, Slither, t 
GA° - Bottle, 3DTTT, Max Graphics, Prix, • 
GA 10 - Blockade, Life, Missilc2. Scramble. t 
GA 1 1 - Bunker 3, Ttrck. Nuke Attack. Traders, ♦ 




Prices: 

T&D Subscription J**"* (Tape or Disk)... $ S\00 *M fa8ue8c ^ Ul i n6 . 1 5 readylonill *p IDgniIIls 

Qftftinoro 2-5 ISSUES 3>6.00 ha. on disk or tape. 

OUllWdl C 6-10 Issues $ 5.00 Ea. *A11 original software includes documentation. 

2490 Miles Standish Drive 1 1 or more Issues $ 4.50 Ea. *We send first class! No charge. 

Holland MI 49424 All Our Software(192 Disks)... $ 279.00 *Pcraona! checks welcome. 

(616) 399-9648 One Year Subscription $ 60.00 ^^m^SSSSt 1,2, or 3. 

Name 







Orisionol Soft 
*6 61 


MM 








Public 


3omain 






1 16 


31 


76 


91 


106 


Ml 


GRI 


El 


Ul 


GAI 


2 17 


32 


47 62 


77 


92 


107 


NO 


GR2 


E2 


II? 


GA2 


3 II 


3) 


48 63 


71 


93 


101 


MS 


GR3 


E3 


in 


GA3 


4 19 

5 20 

6 21 


34 

33 

36 


49 64 

50 65 

51 66 


79 
» 
81 


94 

95 
96 


109 


M4 
M5 


GR4 
GRS 


E4 


U4 
US 


GAS 
GAS 


7 27 


37 


52 67 


82 


97 




M6 


OR6 


HI 


U6 


GA6 


■ 2.1 


31 


53 61 


83 


98 




M7 


GR7 


H2 


U7 


GA7 


9 24 


39 


54 69 


84 


99 






GR8 


H3 


118 


GAB 


10 23 


40 


55 70 


85 


100 




AI 


GR° 


H« 




GA9 


11 26 

12 27 


41 
42 


56 71 

57 72 


86 
87 


tot 

102 




A2 


GRIO 






GAI0 


13 21 


43 


55 73 


81 


103 






GRI1 






GAII 


14 29 


44 


59 74 


89 


104 




Tl 


GRI2 








15 30 


43 


60 75 


90 


105 




T2 
T3 


GRI3 
GRI4 









Address. 
City 



State . 



Credit Card # 
Expiration _ 



Zip_ 



.Total $ , 



Please Circle : 



TAPE or DISK 



STD 

LBSR 

LDA 

LBSR 

PULS 



PADD 

HEXASC 

PADD+1 

HEXASC 

D.X.PC 



BREAK 



JSR 


[$A000] 




CMPA 


#$03 




BNE 


BR3 




LEAS 


4.S 




LDA 


#tFF 


(NO ERASING) 


STA 


l.U 




ANDB 


niiBimi 


VPP OFF 


STB 


.u 


DO IT 


LBRA 


WARM 




CMPA 


#$20 




BNE 


BR2 




JSR 


[$A000] 




CMPA 


#$20 




BNE 


BR1 




RTS 







BR3 



iRl 



BR2 



* OUTPUTS TO DEVICE 2 HEX CHARS 

* FROM A REG ALL PRESERVED 

HEXASC PSHS A 

LSRA 

LSRA 

LSRA 

LSRA 

CMPA 

BLO 

ADDA 

BRA 
OU1 ADDA 
OU2 JSR 

LDA 

ANDA 

CMPA 

BLO 

ADDA 

BRA 
0U3 ADDA 
0U4 JSR 
PULS 



GNUM4 



ONREAD CLR 
LDA 





CMPA 




BNE 




LDB 




BRA 


ONI 


LDB 


ON2 


STB 




PSHS 




LDX 


A@ 


LEAX 




BNE 




PULS 




RTS 



POK 



POl 



TST 

BNE 
LEAX 
LBSR 
LBRA 



#10 

OU1 

#$37 

OU2 

#$30 

[$A002] 

.S 

#$F 

#10 

OU3 

#$37 

0U4 

#$30 

[$A002] 

A. PC 

2.U 

IDENT 

#'3 

ONI 

#%01000000 

0N2 

#%01001000 

,0 

X 

#0 

•l.X 



ERRFLG 

POl 

OK.PCR 

OUTLIN 

WARM 



GNUM3 



TEXT 



TITLE 



PAGE 



ZERO STEPPER 

27256 1/2 
EPROM READ MODE 



CMPA 

BLO 

CMPA 

BHI 

SUBA 

SUBA 

ASL 

ROL 

ASL 

ROL 

ASL 

ROL 

ASL 

ROL 

ADDA 

STA 

BRA 

TSTA 

PULS 



FOB 
FCC 
FCC 
FCC 
FDB 
FCC 
FCC 
FCC 
FCC 
FDB 
FCC 



PFAIL FCC 



SEL 

E64 

E128 

E2561 

E2562 



AT 

EXP 

FOU 



* GETS ASCII POINTED BY X 

* AND PUTS HEX IN D 



GNUM LDD 
PSHS 

GNUM2 LDA 
CMPA 
BLO 
CMPA 
BLS 



n 

D 
,X+ 

#"0 
GNUM3 
#•9 
GNUM4 



INIT TOTAL 
GET CHAR 



OK 



BLANK 



FCB 
FCC 
FCC 
FCC 
FCC 
FCC 
FCC 
FDB 
FCC 
FDB 
FCC 
FCB 

FCC 

FCC 
FCB 
FCC 
FCB 
FCC 
FCB 
FCC 
FCB 

FCC 
FCC 
FCC 

FCC 
FCB 

FCB 
FCB 
FCC 

FCC 



CHECK 
TRANS 
VEPROM FCC 
PEPROM FCC 
EXMEG FCC 

END 



MAKE NUMERIC 



#'A 

GNUM3 

#'F 

GNUM3 

#7 

#•0 

l.S 

0.S 

l.S 

0.S 

l.S 

0.S 

l.S 

0.S 

l.S 

l.S 

GNUM2 

X.PC 



$0D0D 

THE DISTO EPROM PROGRAMMER" .$0D 
BY TONY DISTEFANO".$0D 
V 1.3".$D 
0D0D 

1 - 2764". $0D 

2 - 27128". $0D 

3 - 27256 1/2". $0D 

4 - 27256 2/2". $0D 
$0D0D 

CHOOSE 1. 2. 3 OR 4? ".4 



"EPROM NOT PROGRAMMED PROPERLY 
ADDRESS: ".4 

$0D 

" 1-EPROM ERASED ?".$0D 

" 2-PROGRAM EPROM. ".$0D 

" 3-VERIFY EPROM. ".$0D 

" 4 -READ EPROM. ".$0D 

" 5-RETURN TO BASIC". $0D 

" 6-EXAMINE/CHANGE MEMORY". $0D 

$0D0D 

"COMMAND: " 

$0D0D 

"STATUS :".$0D 

4 

" EPROM SELECTED IS A ",4 

"2764". $0D 

4 

"27128". $00 

4 

"27256 1/2". $0D 

4 

"27256 2/2". $0D 

4 

"AT ",4 

" EXPECTED ".4 

" FOUND ".4 

" - OK!".$0D 



55[$20] 

4 

"CHECKING FOR FF'S".4 

"MOVING EPROM TO MEMORY". 4 

"VERIFING EPROM". 4 

"PROGRAMMING ADDRESS: ".4 

"START ADDRESS? ".4 



AT 



frty 
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An odds-on favorite with Solitaire 
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Iter the article about the CoCo 
3 version of Pyramid ( May 
1991, Page 7X), I received 
many requests for a CoCo 1 
. and 2 version of the program. 
To please as many people as possible, I 
wrote a version of Pyramid that uses the 
PM0DE4 screen and works fine on the CoCo 
I and 2. If you are entering this program 
from the listing in the magazine, pay par- 
ticularly close attention to Line 55. The two 
commas after the PAINT statement are nec- 
essary for the program to work properly. 

When running the program, if the hearts 
and diamonds on the cards appear blue 
instead of red and the backs of the cards are 
red. press the Reset button and run the 
program again. You may have to repeat this 
process three, or more, times. The problem 
is due to the way artifact colors are dis- 
played on the TV screen, and it cannot be 
corrected with software. 

Pyramid is an addictive, easy-to-play 
Solitaire game. Seven rows of cards are 
displayed on the screen at the beginning of 
the game. The first six rows are displayed 
face down and the last row is displayed I ace 
up. The first row contains one card, the 
second row has two cards, the third row has 
three cards, etc. A total of 2X cards are 
displayed on the screen, while 2-1 cards 
remain in the deck. The deck is displayed in 
the upper-left corner of the screen. The top 
card in the deck is displayed face up. 

AAAAAAAAAAAAAAA 

George Quellhorsl has been a CoCo user 
since the days of4K. He has two CoCo 2s 
and a CoCo J with an UGH monitor. He 
enjoys writing programs with his computer 
equipment. Yon may contact him hy writing 
to 63 South Stale St., Apt. to, Painesville. oil 
-I-HI77 or hy calling (2l/>) 154-3812. Please 
include an SASE when requesting a reply. 



Playing the Game 

The object of the game is to move all 
cards in the pyramid to the deck. The game 
has been successfully completed when the 
last card, the lop of the pyramid, has been 
placed on the deck. A card may be moved 
onto the deck when its value is one greater 
or one lower than that of the top card in the 
deck, regardless of the color or suit of the 
card being moved. For example, a five can 
be placed on top of either a four or a six: an 
Ace can be placed on top of a King or a two: 
and so on. 

The program does not allow you to make 
illegal moves. If you attempt an illegal 
move, an error beep sounds and the last key 
pressed is ignored by the computer. A card 
moved to the deck becomes the new top 
card until another card is moved up or until 
you "turn over" the next card in the deck. 
When a legal move is not available, you 
must press the up-arrow key to "turn over" 
the next card in the deck. If the next card 
does not provide you with a legal move, you 
must continue "turning over" cards until a 
legal move becomes available. 

When all 24 cards have been used and 
there are still cards in the pyramid with no 
legal moves remaining, the game has 
reached an unsuccessful completion. A 
successful completion ofthe game involves 
moving all 28 cards to the deck before 
running out of cards in the deck. 

Manipulating the Cursor 

The cursor appears as a blinking border 
around the card being put into play. The 
cards in the pyramid are numbered (for 
programming purposes) from I to 2x start- 
ing at the top of the pyramid and moving 
from left to right down the pyramid. Press- 
ing the right-arrow key moves the cursor to 
the next higher-numbered card being dis- 
played face up in the pyramid. The left- 
arrow key moves the cursor to the next 
lower-numbered card in the pyramid. The 
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cursor will not slop on an empty spot. If a 
card has been moved to the deck, the cursor 
skips that "empty" position in the pyramid. 
The cursor also has a wrap-around feature. 
If you move the cursor to the right side of 
the screen with the right arrow, pressing 
this key once more causes the cursor to 
move to the left side of the screen. 

The Ups and Downs 

Pressing the up-arrow key turns the next 
card in the deck over and places it on the lop 
of the deck. If no legal move is available 
after turning over the next card, you must 
continue to press the up-arrow key until a 
legal move becomes available. The Cards 
Remaining Counter, displayed below the 
deck, keeps a running count of the remain- 
ing cards in the deck. 

The down-arrow key is your "oops" key. 
Pressing the down-arrow key restarts the 
current game without shuffling the deck. 
You may use this option when you make a 
mistake, or if you want to play the same 
game with a different strategy. 

The ENTER Key 

Pressing ENTER takes the card situated 
beneath the cursor anil places it on the top of 
the deck, if the move is legal. You can 
continue to play as long as legal moves 
remain. When a card in the pyramid is no 
longer covered by any other card, the 
computer turns that card face up. 

The Space Bar 

Pressing the space bar restarts the game. 
The deck is shuffled and you get a fresh 
game. Press Q or the BREAK key to slop the 
program. 

Summary 

The program "knows" when the deck is 
empty, cards remain in the pyramid, and no 
legal moves remain. It informs you of your 
loss and displays the available options on 
the .^-column screen. The program also 
"knows" if you have won the game and 
announces this event in a similar manner. 
The program is as fast as it can possibly be 
since the cards are moved from the pyramid 
to the deck with GET and PUT commands. 
The only cards drawn are those that are 
turned over and those produced in the deck 
when you press the up-arrow key. 

This game is very addictive. It is almost 
impossible to stop playing once you start. A 
lot of luck is needed to win. but a certain 
amount of strategy is also required since 
there are many times when three or more 
legal moves are possible at once. 

Feel free to contact me if you have any 
questions about this game. For a response 
by mail please include an sask. Or you may 
call me from S a.m. until Mi p.m. K.ST. J 
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8 124 51 185 

19 112 60 143 

30 249 67 160 

43 31 75 149 

48 12 END 41 



The Listing: PYRAMID2 

'PYRAMI02 

** WRITTEN BY GEORGE QUELLHORST 

1 'COPYRIGHT (C) SEPTEMBER 1991 
** BY FALSOFT. INC. 

** RAINBOW MAGAZINE 

2 DATA 112.1.94.25.130.25.76.50. 
112.50.148.50.58.74.94.74.130,74 
.166.74.40.98.76.98.112.98.148.9 
8.184.98.22.122.58.122.94.122.13 
0.122.166.122.202.122.4.146.40.1 
46.76.146.112.146.148.146.184.14 
6.220.146 

3 CLEAR1000:SH-1:POKE140.190:EXE 
C43350:DIM AC0.34 ) .B(0.34) .C(0.3 
4).D(0.34).E(0.34).NS(13),X(29), 
F(29).Y(29).CA(52):R=RND(-TIMER) 

4 POKE65495.0:CLS:IFSH-1 THENPRI 
NT0194. "PLEASE WAIT. SHUFFLING C 
ARDS":G0SUB53 

5 G0SUB48:G0SUB43:T=25:DE=29 

6 ' CURSOR CONTROL 

7 P$=INKEY$ 

8 DRAW"C0BM"+STR$(X(T))+"."+STR$ 
(Y(T))+A$ 

9 IFDE-52 ANDMO-1 THENG0SUB63 

10 IFP$-CHR$(8)THENT=T-1 ELSEIFP 
$-CHR$(9)THENT=T+l ELSE13 

11 IFT~>29THENT=1ELSEIFT=0THENT= 
28 

12 IFF(T)-0 OR F(T)=2 THEN10ELSE 
EXEC 

13 IFP$-CHR$(13)THENF(T)=2:G0T01 
9 ELSEIFPJ-CHR$(94)THENEXEC:G0T0 
37 

14 IFP$=CHR$(10) THENSH=0:CA(0)= 
AC:G0T04ELSEIFP$-" "THENSH-1 :G0T 
04 

15 DRAW"ClBM"+STR$(X(T))+"."+STR 
$(Y(T))+A$ 

16 IFP$-"Q"THENCLS:STOP 

17 GOTO 7 

18 ' THE ENTER KEY 

19 GOSUB57:Q-0:EC=W:TT-T:T-0:GOS 
UB57:Q-0:TC-W 

20 IFEC-TC-1 OR EC-TC=12 OR TC-E 
C-l OR TC-EC-12 THENT-TT:G0T022 

21 G0SUB61:T-TT:F(T)-1:G0T07 

22 EXEC:H-T:GOSUB75:GOSUB71:H-0: 
GOSUB72 

23 H-T-1:G0SUB76:H-T+1:G0SUB77:C 
N-T-(Y(T)/25):IFF(1)-2THEN67 

24 L-CN-1:R=CN:IFY(L)-Y(R)THEN25 
ELSEIFX(T)>112THEN28 ELSEIFYUX 
>Y(R)THEN27 

25 H-L:GOSUB70:H-R:GOSUB70 

26 H-T-1:G0SUB73:H-T+1:G0SUB74:G 
0T029 

27 H-R:GOSUB70:H-T+1:GOSUB74:GOT 
031 

28 H-L:GOSUB70:H-T-1:GOSUB73:RS- 
1:G0T029 

29 IFF(T-1)=2 THENTT-T:T-L:F(L)= 



1:GOSUB47:GOSUB57:GOSUB55:Q-0:T- 
TT 

30 IFRS=1THENRS=0:GOTO32 

31 IFFCT+D-2 THENTT-T:T-R:F(R)- 
1:GOSUB47:GOSUB57:GOSUB55:O-0:T- 
TT 

32 CA(0)=CA(T) 

33 T-T+1:IFT->29THENT-1 

34 IFF(T)-0ORF(T)-2 THEN33 

35 M0=1:G0T07 

36 " THE UP-ARROW KEY 

37 IFDE-52 THENG0SUB61 :G0T07 

38 TT-T : DE-DE+1 : T=DE : X-10 : Y-10 : P 
UT( X . Y ) - ( X+30 . Y+42 ) . B . PSET 

39 GOSUB57 : DRAWS4BM10 . 10"+A$ :T- 
0:GOSUB55 

40 PUT(10.55)-(40.97).B.PSET:GOS 
UB78:DRAW"S4C0BM13.60"+R$(D1)+"B 
R14"+R$(D2) 

41 T-TT:Q=0:CA(0)=W:GOTO7 

42 " DRAW SCREEN 

43 A$-"R30D42L30U42":MO-l:F(0)-2 
: PM0DE4 . 1 : PCLS5 : SCREEN1 . 1 : DRAW'S 
4C0BM10.10"+A$:POKE178.54:PAINT( 
20.20). ,0:GET( 10. 10) (40.52). A.G 
:GET(140.10)-(170.52).B,G 

44 T-0:X(0)-10:Y(0)-10:GOSUB47:R 
ESTORE:FORT-1TO21:F(T)=0:READX(T 
).Y(T):G0SUB46:NEXT:F0RT-22T028: 
F(T)-1:READX(T).Y(T):G0SUB47:NEX 
T 

45 O=0:W-0:T-0:GOSUB57:GOSUB55:Q 
-0:FORT-22TO28:GOSUB57:GOSUB55:O 
-0:NEXT:DRAW"S4C0BM13.60"+R$(2)+ 
"BR14"+R$(3):RETURN 

46 PUT(X(T).Y(T))-(X(T)+30.Y(T)+ 
42).A.PSET:ORAW"C0S4BM"+STR$(X(T 
))+"."+STR$(Y(T))+A$: RETURN 

47 PUT(X(T).Y(T))-(X(T)+30.Y(T)+ 
42),B.PSET:DRAW"C0S4BM"+STR$(X(T 
))+"."+STR$(Y(T))+A$: RETURN 

48 N$( 1 )="BR3R3F3D4LU4H3LG3D4LU4 
E3BL2BD5R7":N$(2)-"BRR7FD2GL6GD2 
R8ULDL8U2ER6EU2HBL6DLU":N$(3)="B 
RR7FDGFD2GL7HUBRDFBR5EU2HL3BR3EU 
HBL5GDBLUE":N$(4)-"BR4R4D4R2L2D3 
LU7BL2G4R6BL7E4" 

49 N$(5)="BR9L9D3RU3BD3R7FD2GL7H 
URDFBR5EU2H":N$(6)-"BR9L8GD5FR7E 
U2HL6BLU2EBGBD2BRGD2FR5EU2H":N$( 
7)-"R9DG6LE6UBL7DLU":N$(8)-"BRR7 
FDGFD2GL7HU2EHUEBRGDFR5BL5GD2FBR 
5EU2HEUH":N$(9)-"BRR7FD5GL8BR7EU 
2BLEU2HBL5GD2FR5BL5BLHU2E" 

50 N$(10)="BR2RD7BR2L5BR2U6GLE2B 
R6R7FD5GL7HU5EBRGD5FBR5EU5H":N$( 
11)-"BR4R5BL206GL5HURDFBR3EU6L2" 
:N$(12)-"R9D7L9U7BRD7BR7U7D6LF2R 
2UL2":N$(13)-"R2D7LULDRU7L0RBRBD 
3E4R2GLG4BEF3R2HLH3":R$(0)-"R7FD 
5GL7HU5EBRGD5FBR5EU5HBL8" 

51 C$(1)="BR13R3F3D5G10H10U5E3R3 
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F4E4":C$(2)-"BR8R2F8DG8L2H8UE8": 
CS(3)-"BR10F9D2G2L2H3LGD3F2L6E2U 
3HLG3L2H2U2E10":C$(4)-"BR8R2F3D2 
G3F2E3RF3D2G3LH3L2D3F2L6E2U3L2G3 
LH3U2E3RF3E2H3U2E3" : R$( 1 )="BR2RD 
7BR2L5BR2U6GLE2BL5":F0RP=2T09:RS 
(P)-N$(P):NEXTP:RETURN 

52 " SHUFFLE THE DECK 

53 FORT-1T052:CA(T)-T:NEXT:FORT- 
1T052:R-RND(52):S-CA(R):CA(R)-CA 
(T):CA(T)-S:NEXT:SH-0:AC-CA(29): 
CA(0)-CA(29):RETURN 

54 ' DRAW CARDS ON SCREEN 

55 DRAW"S4C0BM"+STR$(X(T)+6)+"." 
+STRJ(Y(T)+20)+C$(Q):DRAW"S4BM"+ 
STR$(X(T)+4)+"."+STR$(Y(T)+4)+N$ 
(W):P0KE178.HC:PAINT(X(T)+15.Y(T 
)+25)..0:RETURN 

56 ' COMPUTE SUIT AND VALUE OF C 
ARD 

57 W-CA(T) 

58 IFW<-13THENQ-Q+l:GOT059:ELSEW 
-W-13:Q=Q+1:G0T058 

59 IFQOTHENHC-1ELSEHC-0 

60 RETURN 

61 POKE140.20:FORD-1TO10:EXEC:NE 
XT:POKE140.190:RETURN 

62 ' CHECK STATUS OF GAME 

63 MO-0:TT=T:FORK=1TO28:IFF(K>=1 
THENT-K:GOSUB57:Q-0:TC-W:T=0:GO 

SUB57:Q-0:EC-W:T-TT ELSE65 

64 IFEC-TC-1 OR EC-TC-12 OR TC-E 
C-l OR TC-EC-12 THENRETURN 

65 NEXTK:GOSUB61:CLS:PRINT@101." 
GAME IS OVER YOU LOST" : PRINT0133 
. STRINGS (21."*"): PRI NT@205."PRES 
S:":PRINT@259. "SPACEBAR FOR ANOT 
HER GAME":PRINT@323."D0WN ARROW 
FOR SAME GAME":PRINT@390. "PRESS 
<Q> TO QUIT" 

66 P$-INKEY$:IFP$-" "THENSH-1 :GO 
TO4ELS£IFP$-CHR$(10)THENSH=0:CA( 
0)-AC:GOTO4ELSEIFP$-"Q"THENCLS:S 
T0PELSE66 

67 CLS:PRINT@36."WELL. YOU FINAL 
LY DID IT.":PRINT@72."YOU WON TH 
E GAME":PRINT@104."CONGRATULATIO 
NS ! " : PRI NT@1 29 . STRI NG$ ( 30 . "*" ) : P 
RINT@205. "PRESS: " : PRINT@259 ."SPA 
CEBAR FOR ANOTHER GAME": PRI NT@32 
3. "DOWN ARROW FOR SAME GAME": PRI 
NTO390. "PRESS <0> TO QUIT 

68 PLAY"T2L5:02BAGD01D02ABG":G0T 
06 

69 'PUT AND GET CARDS ON SCREEN. 

70 PUT(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).A.PSET:RETURN 

71 PUT(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).B.PSET:RETURN 

72 PUT(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).C.PSET:RETURN 

73 PUT(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).D.PSET:RETURN . 

74 PUT(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).E.PSET:RETURN 

75 GET(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).C.G:RETURN 

76 GET(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).D.G:RETURN 

77 GET(X(H).Y(H))-(X(H)+30.Y(H)+ 
42).E.G:RETURN * 

78 ED-52-DE:DE$-STR$(ED):lFED<10 
THENMID$(DE$.l.l)-"0" ELSEDE$-R 

IGHT$(DE$.2) 

79 D1-VAL(LEFT$(DE$.1)):D2-VAL(R 
IGHT$(DE$.1)):RETURN ,_ 



The Rainbow Bookshelf 



The Rainbow Book of Simulations, 20 award-winning entries from THE RAINBOW'S first Simu 

lations contest. 
The Seeond Rainbow Book of Simulations, the 16 Winners from our second Simulations 

contest. 
The Complete Rainbow Guide to OS-9, authors Dale Puckett and Peter Dibble demonstrate 

OS-9's multitasking and multiuser features. 
The Complete Rainbow Guide to OS-9 Level II Vol.1: A Beginners Guide to Windows. Puckett 

and Dibble uncover the mysteries of the new windowing environment. 
The First Rainbow Book of Adventures, contains 14 winning programs from our first Adventure 

contest. 
The Second Rainbow Book of Adventures, featuring 24 of the most challenging Adventure games 

ever compiled. 
The Third Rainbow Book of Adventures, the Excitement continues with 19 new Adventures. 
The Fourth Book of Adventures, fourteen fascinating new Adventures from the winners of our 

fourth Adventure competition. 
A Full Turn of the Screw 
The Rainbow Introductory Guide to Statistics, Dr. Michael Plog and Dr. Norman Slen/el give a 

solid introduction to the realm of statistical processes. 



\Z 



7 



Name 
Address 
City 



State 

J Payment Enclosed, or 
J VISA 



Zip 



J Charge to: 
j MasterCard J American Express 

Accounl Number 

Card Exp. Date 



Signature 



$J3r9lf 

$19 90 
S 9.95 
$ 9.95 
$10.95 
$19.90 
$20.90 
$19.95 
$31.00 
$47.95 



$ 7.95 
S 7.95 
$15.90 
$13.95 
$13.95 
$27.90 
$11.95 
$ 9.95 
$14.95 
$21.90 
$26.90 
$10.95 
$ 9.95 

$14:95 

$20.90 
$25.90 

$ 6.95 
iS 5.95 
$12.90 



$ 3.50 
$ 3.50 
$ 6.00 
$ 4.95 
$ 4.95 
$ 4.95 
$ 8.95 
$ 8.95 
$12.95 
$19.95 
$29.95 



$19.95 . 
$ 2.00 . 
$ 2.00 
$ 3.50 
$ 6.95 . 
$ 6.95 
$11.95 
$ 6.95 
$ 6.95 
$ 7.95 
$11.95 
$12.95 
$ 7.95 
$ 6.95 
$11.95 
$13.90 
$18.90 
$19.95 
$ 2.95 
$ 2.95 
$ 4.95 



j The Rainbow Book ol Simulations (first) 

J Rainbow Simulations Tape (lirsll 

j First Simulations Package 

jThe Second Rainbow Book ot Simulations 

j Second Rainbow Simulations Tape 

j Second Rainbow Simulations Disk 

j Second Simulations Package with Tape 

J Second Simulalions Package with Disk 

j The Complete Rainbow Guide to OS-9 

j Rainbow Guide to OS-9 Disk Sel (2 disks) 

J Rainbow Guide lo OS-9 Package 

j The Windows & Applications Disk lor 

The Complete Rainbow Guide 

to OS-9 Level II, Vol I 
jThe Rainbow Book of Adventures (first) 
J Rainbow Advenlures Tape (first) 
j First Adventure Package 
jThe Second Rainbow Book of Adventures 
j Second Rainbow Adventures Tape 
J Second Advenlure Package 
jThe Third Rainbow Book ol Adventures 
j Third Advenlures Tape 
j Third Advenlures Disk Set (2 disks) 
j Third Adventure Package with Tape 
j Third Advenlure Package wilh Disk 
jThe Fourth Rainbow Book ot Adventures 
j Fourth Advenlures Tape 
J Fourth Adventures Disk 
j Fourth Adventure Package wilh Tape 
J Fourth Advenlure Package wilh Disk 
j A Full Turn of the Screw 
j Introductory Guide to Statistics 
J Guide lo Statistics Tape or Disk (indicate choice 
j Guide lo Statistics Package 

(indicate choice of tape or disk) 

Add $2 per book Shipping and Handling in U.S. 

Outside U.S.. add $4 per book 

Kenlucky residents add 6% sales tax 

Canadian residents add 7% GST 

(Allow 6 to 8 weeks lor delivery) 

7~ 



Mail to: Rainbow Bookshelf, The Falsoft Building, P.O. Box 385, Prospect, KY 40059. To 
order by phone (credit card orders only) call (800) 847-0309, 9 a.m. to 5 p.m. EST. For other 
inquiries call (502) 228-4492.Please note: The tapes and disks offered by The Rainbow 
Bookshelf are not stand-alone products. That is, they are intended to be an adjunct and 
complement to the books. Even if you buy the tape or disk, you will still need the appropriate book 
for loading and operating instructions. OS-9 is a registered trademark of the Microware Systems 
Corporation. 
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Pro ven 



On the Razor's Edge of 



The New Frontier: 



The Most Advanced Color Computer 
Drive Systems Ever Offered! 



Fast No-Halt SCSI Floppies Using Optiona 
Proven Performance for Demanding Home or 



This is the most advanced, fully assem- 
belcd CoCo hard drive system offered. 
Using the optional 0MT1 5200 SCSI 
controller with our Hard Drive Inter- 
face, our new system will support 
no-halt floppy drives. You need not wail 
while typing or worry about clock lime 
losses. Why be limited to 3 floppy 
drives? A complete system could now 
consist of 1-3 standard CoCo floppy 
drives, 1-2 (or more) hard drives, and 
1-3 no-halt floppies using standard (not 
just CoCo) OS/9 format. You can use 



single or double-sided 40 or 80 track 
drives with the SCSI no-halt controller. 

There arc several new features with this 
improved interface. These include: 

• Full SASI/SCSI compatible (this al- 
lows many add-ons to the versatile 
SCSI buss) 

• No-Halt Floppies with optional SCSI 
controller allows full type-ahead 
during access 

• Low factory-direct prices 



I SCSI Controller 
Business Users 

• Fast Delivery from factory stock 

• Optional Real Time Clock with built 
in battery (3-10 year lifetime) 

• With the Clock you have 240 Bytes of 
battery backed up RAM for password 
protection or data storage! 

• Same super stable LRTech quality 



Interface Price only: $85. 
Real Time Clock-RAM: $25. 



20 or 30 Meg. 40 Meg. 80 Meg. 

System Prices: (Includes Hard Drive, case, & fan, SCSI Controller*, 
LR/OWL Interface, Software. Fully assembled and tested.) 

$495. $535. $875. 

Super System Prices: (LR/OWL System as above but OMTI 5200 
SCSI Controller AND 3.5" or 5.5" HD 80 Track Floppy in same case) 

$595. $645. $1039.(2 cases) 

•SCSI controller is OMTI 5100. Add S75 for OMTI 5200 with FDC. 

Introducing the Quick-Link" Interface 

Provides both a 64K Printer Buffer and Serial and Parallel Interfaces. 

Serial to Parallel Printer Interface (64K Buffer) $65. 

Converts serial computer output lo parallel printer and also provides a 64K huffcr in front of the 
printer. Serial side Female DU-25 and Parallel side is Centronics. Includes Centronics to Centronics 
cable and power AC -adapter. If you need an adapter from the CoCo 4-pin serial to DB-25 add $9. 
From 300-38.400 Baud. 



Parallel to Serial Interface (64K Buffer) 



$45. 



Same as above except it converts Centronics parallel computer output lo DH-25 Female serial. Plug 
into an IBM printer cable to provide output lo a serial plotter. 



Parallel to Parallel (64K Buffer) 

This is parallel printer buffer with no conversion. 



$39. 



Drive System Parts 

Hard Drives 

20/30 Meg ST/PTI S229. 

40 Meg PTI 265. 

80 Meg ST40% 590. 

SCSI Controllers 
OMTI 5100 HDOnly $79. 

OMTI 5200 HD/KD 169. 

OMTI 5400 HD/FD/Tape 199. 

(Nole: We have no drivers for tape yet) 

Cases and Cables 
Case, 45 Watt PS, Fan $ 1 05. 

Cable set (3 pieces) 25. 

Drives have a 1-year limiicd warranty. 
Olher parts are 90-day warraniy 
Please Note - At these prices, only very 
limited support can be given. 



Technology 



the Color Computer Frontier 




Floppy Drive Systems 

The Highest Quality for Years of Service 
Drive Systems (Half Height, Double Sided, 

Direct Drives) 5|> I 0^7- 

Drive systems complete with drive, controller, legal DOS, cable, case, 
power supply, and manual 

Drive 1 Systems (Half Height, Double Sided, 
Direct Drives) %(> I 1 O- 

New 3.5", 720K Drives for OS-9 with case 

& Power Supply 5)> I *\\3 » 

Drive 1 Systems have drive, case, power supply. (You may require op- 
tional cable and/or DOS chip to use) 

Special for 0/1 Combos (0,1,2,3) $259. 
SALE Prices on Drives! 



HALF- HEIGHT DRIVE 
UPGRADES FOR RS HORIZON- 
TAL CASES 

Why only double the capacity of your 
system when you'ean triple in the same 
case? Kit includes: double-sided to fit 
your case, chip to run both sides of new 
drive, hardware, and detailed instruc- 
tions. Easy! Takes only 5 minutes! 

Model Only $119. 

500, 501, Of 502 



OWL Phones 

Order Numbers (only) 

1-800-245-6228 

1-215-682-6855 

Fax: 1-215-837-1942 

Technical Help 

1-215-837-1917 



All drives are new and fully assembled. 
We ship only FULLY TESTED and 
CERTIFIED at these low prices. We 
use Fuji, YE Data, and other line 
brands. No drives are used or surplus 
unless otherwise stated to you when 
you order. We appear to be the one ol 
the few advertisers in Rainbow who 
can truly make this claim. We have 7 
years experience in the CoCo disk 
drive market! We are able to provide 
support when you have a problem. 



OWL WARE Software Bundle 



Disk Tutorial/Utilities/Games 
DISK TUTOR Ver 1.1 

Learn how to use your disk drive Irom 
this mulli-lesson, machine language 
program. This tutor lakes you through 
your lessons and corrects your mistakes 
for a quick, painless disk drive introduc- 
tion. (This professionally written tutor 
is easily worth the bundle's total price.) 

3 UTILITIES 

A copy verify, copy, and DOS utility. 

2 GAMES 

Wc will select 2 games from our slock. 
These are sold for more than $20 each. 



Do not mistake this software with cheap 
Public Domain" software which others 
iffer. All of this software is copyrighted 
and professional in quality. The tutor is 
unique with us and has helped 
thousands of new users learn their disk 
drive. . 



only $27.95 

(or even better) 

only $6.95 with 

any Disk Drive Purchase!! 



512K Upgrade 

Again at a popular price. Fully as- 
sembled and tested before shipping. 
Easy to install. Uses fast 120 ns. chips. 

Only $85. 

Now includes memory test, Ram Disk 
Lighting, Printer Lighting, and Back- 
up Lighting. All with an upgraded 
manual exclusive with OWL! 



Our prices include a discount for cash but 
do not include shipping. 

OWL-WABE has a liberal warranty policy. During Ihe warranty 
period, all detective items will be repaired or replaced at our 
option at no cost to the buyer except lor shipping costs. Call 
our tech number for return. Return ot non-detective or un- 
authorized returns are subiect to a service charge. 



Drives 1 Year Warranty 



OWL-WARE 

P.O. BOX 116 

Mertztown, PA 19539 




OS-9 
Hotline 



Basic to OS-9 Connection 



THE RAINBOW Staff 



HI was very interested in Marty Gold- 
stein's letter and your reply in the 
Alii- list 1991 issue about showing 
graphics with OS-9, It would combine my 
two main interests. But I don't know how to 
transfer my . CH3and .MGE pictures to a disk 
formatted with OS-'). If I try it from BASIC. I 
get DF error. And if I try it from OS-9. 1 get 
Error 249 (wrong type) or Error 24-1 (read 
error). Can you help me? 

Dorothea Clement 
Amityville. New York 

B Several utilities are available for trans- 
ferring files from Disk BASIC to os-9. 
If you have access to CompuServe or 
Delphi, you can download RS20S9.BAS. 
This short basic program installs an OS-9 
directory on a Disk BASIC disk, allowing 
you boot OS-9 and copy the files from that 
disk onto a standard OS-9 format disk. Also 
available is Bob Santy's excellent rsdos 
utility. This OS-9 program allows you to 
copy files between Disk basic and OS-9 in 
either direction. If you do not have access to 
either CompuServe or Delphi, you may 
want to look into the commercial utilities 
available. GCS File Transfer Utilities from 
Granite Computer Systems allows you to 
transfer files between OS-9, Disk basic. MS- 
DOS. Flex and Mini-Flex. For further infor- 
mation, read "Making the Move" by Tim 
Kientzle on Page 10 of this issue. 

Terminal Warfare 

/ have a 5I2K CoCo 3, a CMS monitor, 
two FD-501 disk drives, a -iii-track disk 
drive with a Disto controller, an KS- 

232 Pak. a Multi-Pak Interface, an Avatex 

I2t)()-bps modem, a DMP-106 printer and a 

Smith-Corona L-I000 printer. 

My problem is with XTerm, which I 

bought about two years ago and cannot use. 



I boot OS-9 and enter xmode /t2 baud-3/« 
set I tZ for 1200 bps. I get connected but 
when I start to type, everything looks like 
the Creek alphabet. I have tried to operate 
at Mm bps. but the same thing happens. I 
have done everything that has been sug- 
gested and I still get the same results. I have 
SuperComm and it works perfectly. I also 
have MikeyTerm <//;</ GETerm. 

Augustus Harrison 
Ticonderoga. New York 

We suspect XTerm is not stripping the 
parity bit from the received data. De- 
pending on the system you are call- 
ing, you may need to experiment with the 
number of data bits and parity to achieve an 
acceptable connection. While most popular 
systems use K-bits with no parity, some 
systems still operate at 7-bits with either 
even or odd parity. You can change the 
speed, number of data bits and parity by 
altering the baud and type values with the 
xmode utility. The baud parameter is split 
into two hexadecimal digits. The upper 
digit represents the number of data bits and 
the lower digit represents the speed. Use 
these values in the upper digit to set the 
number of data bits 



Data bits 


baud parameter 


8-bits 


Ox 


7-bits 


Iv 



where x is the speed code in the lower digit 
from the following table: 



Code 


Speed 





no bps 


1 


300 bps 


2 


600 bps 


3 


1200 bps 


4 


2400 bps 



5 
6 

7 



4800 bps 
96(X) bps 
19.200 bps 



To set the parity in the type parameter, 
use the codes in the following table: 



type 


Parity 


00 


None 


20 


Odd 


60 


Even 


A0 


Mark 


E0 


Space 



For example, to set /t2 for 1200 bps. 7 bits 
and even parity, use the command 

xmode /t2 baud-23 type-60 

If you find that x-bit. no parity results in 
the Greek alphabet, try using 7-bit. even 
parity and then 7-bit, odd parity. If neither 
of those work properly, try using mark or 
space parity. Mark and space parity are 
rather unusual in that the parity bit is either 
always set (mark) oralways reset (space). If 
you are still unable to obtain an acceptable 
connection, read the manual for the termi- 
nal program to see if it offers any assis- 
tance. Many of the better terminal pro- 
grams offer a feature that strips the parity 
bit. 

For more information on setting the 
parameters for the serial port, read pages 5- 
4 through 5-7 of the OS-9 Commands section 
of the OS-9 Level ll manual. Also read the 
descriptions for the tmode (Page 6-87) and 
xmode (Page 6-iou) commands. 







Patching OS-9 Level I 
/ am writing in hopes that you or a 
reader of this column can help me. I 
have just obtained a copy of OS-9 Level 
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/. // seems that it runs only on the CoCo 2. 

I read in an earlier issue of a patch avail- 
able from Tandy to lei you run the program 
on the CoCo 3 . 1 am unable to purchase one 
from Radio Shack because it was discontin- 
ued in May 1990. 1 would appreciate help in 
obtaining this patch if it is available. 

Mike I toward 
Easley. South Carolina 

BThe besl solution would be to obtain 
OS-9 Level II since it was designed 
specifically for the CoCo 3 and pro- 
vides many advantages over OS-9 Level I. 
But for guidance to a patch that allows OS- 
9 Level I to work on the CoCo 3. read the 
next letter. 

A Game's Solution 

Bin "OS-9 Hotline" (August 1991, Page 
40). you told Charles Retnpel that the 
only version of OS-9 Level I that runs 
on the CoCo 3 is Version 2.00. 1 beg to differ: 
if you check Page 98 of the January I9H9 
issue, you will find "Tandy OS-9 Games 
Patch" by Marty Good/nan. Although it is 
written as a game patch, you will find that 
it patches OS-9 Level I Version 1. 00 or 1. 01 to 
work with the CoCo 3. 

Ken Yarley 
Columbus, Ohio 

Thanks for the tip. 

Changing Slots 

HI am interested in knowing if there is 
a way to edit either the / 1 2 device de- 
scriptor or the a c i a pa k device driver 
to operate out of Slot 2 of the Multi-Pak 
Interface rather than Slot I . I use Super- 
Comm 2. 1 as my main terminal program 
with OS-9 but would like to keep Slot I open 
for my kids, who use several ROM Pak 
games. 

I tried deleting both aciapak and t2 
from my MODULES directory and replacing 
them with mod pa k and t 3. but that seemed to 



m ork only at 300 bps. With aciapak and 1 2 . 
/ am able to run at 2400 bps with no problem. 
but I am limited to Slot I . Alternatively, is it 
possible to modify either mod pak or t3 to 
operate at 2400 bps with SuperComm 2. 1 '.' 
I tried to set 1 1 3 to 2400 bps with xmod e . but 
that didn't seem to help. 

Kent 1 1 ol comb 
North Royal ton. Ohio 

B Changing the slot number requires 
disassembling the aciapak device 
driver, determining the location that 
changes the slot-select register in the Multi- 
Pak Interface and then either reassembling 
or patching the driver. We am not aware of 
any patches currently available. Perhaps 
one of our readers is aware of a patch and 
will forward that to us. 

BAS1C09-Vue 

'2*1 ' nave a * I2K CoCo 3 with two disk 
KJ drives and enjoy the many challenges 
¥ of programming using BASIC09. 1 also 
have Multi- Vue but have been unable to de- 
termine from the manual an answer to the 
following question: Can I use BAS1C09 with 
Multi- Vue.'' If SO, what are the procedures 
for loading it? 

Burton Parke 
Clearwater. Florida 

5 For further information on using the 
menuing capabilities provided with 
I Multi-Vue, read "Kissable OS-9" 
(August 1988. Page 182) for BASIC09 source 
code to the gf x3 module. You may also be 
interested in reading Dale's three-part se- 
ries on Maxic in Multi-Vue (September. 
October and November 1990) and MVFi- 
nance (April 1990. Page 52). The complete 
source code to Maxic was provided on the 
August 1 990 rainbow ON DISK. If you have 
access to CompuServe or Delphi, you may 
also be interested in downloading the 
complete assembly-language version of 
gf x3 provided by Kevin Darling. 



Using the Default Device 

BHow do I use the /dd device'.' When I 
load it with /dO set as a 40-traek, 
double-sided drive, I get error mes- 
sages. The only way I can get /dd to work is 
with 35-track single-sided disks. How can I 
combine the two? My system includes two 
double-sided disk drives and 5I2K. 

Walter Jones 
Georgetown. Delaware 

a Located in the MODULES directory of 
the Boot/Config/BASiaw disk are two 
files called dddO 35s.dd and 
dddO 40d .dd. The ddd0_35s .dd is the /dd 
descriptor configured for /dO as a 35-track, 
single-sided drive, and dddO 40d.dd is the 
/dd descriptor configured for /dO as a 40- 
track, double-sided drive. Since you have 
two double-sided drives, you should replace 
dddO 35s. dd in your 0S98oot file with 
dddO 40d.dd. You can do this by using 
conf i g to create a new boot disk or by using 
EZGen (available from Burke & Burke) to 
replace the current version of dd in your 
0S9Boot file with the version you need. If 
you want to use F./.Gen. insert a backup of 
your System Masterdisk into Drive /dOand 
the Boot/Config/BASiaw into Drive /dl, 
and type the following: 

ezgen /d0/os9boot 

link dd 

del ete 

insert /dO/modules/dddO 40d.dd 

quit 

EZGen allows you to create a new boot 
disk from scratch, and you can add. delete 
or replace device drivers and descriptors on 
your existing boot disk. However, it is best 
to modify the 0S9Boot file on a backup of 
your current OS-9 System Master. This al- 
lows you to easily recover, should a prob- 
lem occur that renders the disk unbootable. 
Otherwise, you'll have to start from scratch 
anyway. /?5\ 



The Print Shop 
For Free 

...Well practically. Send us S 10 to cov- 
er the costs of shipping, order process- 
ing, manual printing, and disk duplica- 
tion, and we'll send you our best selling 
Coco Graphics Designer Plus. The 
CGDP is the closest thing on the CoCo 
to the Broderbund's Print Shop for IBM 
and Apple Computers. This tried and 
true formSta for graphics productivity 
comes with Fonts, Graphics and Border 
collections. The CGDP prints banners, 
signs, and greeting cards, includes a 
clear 64 page users manual, and re- 
quires a 64K CoCO II or III, mouse or 



joystick, disk drive, and supports most 
popular printers. The CGDP is one of 
the most popular and useful CoCo Pro- 
grams ever written. 

This offer is limited to one copy per 
family to first time Zebra customers 
only. It's our rather extreme way of in- 
troducing the Zebra product line to 
those CoCo users who've read all the 
great reviews of our products over the 
years and still haven't tried them. S10 
includes everything ( except PA resi- 
dents must add S.60 sales lax). Offer 
good for mail orders only and expires 
October 30, 1991. Checks, MO's, 
V1SA/MC. No COD's. 

The Print Shop is a trademark ot 
Broderbund Software Inc. 



FD502 DISK 
DRIVES $119.95 

Everything you need to add the first 
disk drive (Drive 0) to your 64K CoCo 
II or II. Includes disk drive in case 
with power supply, disk controller with 
cable, Disk BASIC, and manual. Radio 
Shack closcoul, all in original boxes, 
tested and warrantecd 90 days by Zebra 
Systems. Continental US add S10 
S&H plus S4 for UPS CODs. Canada 
add SI 5 for S&H. Quantities limited. 

Zebra Systems, Inc. 

121 S. Burrowes Street 

State College, PA 16801 

(814) 237-2652 
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CoCo 
mi Consultations 



Power Connections 



by Marty Goodman 

Contributing Editor 



^^k I've seen some power adapters for 
^^_ .-> ,; 2-inch drives thai supply only 5 volts 
to the drive. What is going on here? Are 
some (or all) modern 3'A-inch drives set up 
to use only 5 volts for both their circuitry 
and their motors? 

EdDahlgren (EDOAIILGREN) 
Colorado Springs. Colorado 

A Yep! Many of the more recent 3'A- 
inch. l .44-megabyte disk drives these 
days run both their motors and circuit boards 
off a single S-volt supply. However, most (if 
not all) older 3'/:-inch drives — especially 
those that were 720K only and half-height 
(as opposed to the newer third-height drives 
that can operate as both 720K and as t. 44- 
megabyte drives) — do require both S and 
12 volts. 

CoCo Cat Fights Back 

^^k A while ago my cat sprayed nn disk 
™." controller, and since then I've been 
getting some intermittent disk errors. What 
do you suggest? 

Bruce Christianson (TIIEWANDERER) 
Denver. Colorado 

A I suggest washing off the control- 
ler circuit board with lukewarm wa- 
ter. This should dissolve and rinse off any 



Martin H. Goodman, M.D., a physician 
trained in anesthesiology, is a longtime 
electronics tinkerer and outspoken com- 
mentator — sort of the Howard Cosell of 
the CoCo world. On Delphi. Marty is the 
SIGop of rainbow's CoCo SIC, and database 
manager of OS-9 Online. His non-computer 
passions include running, mountaineering 
and outdoor photography. Marty lives in 
San Pablo. California. 



remaining salt left from the evaporated 
feline urine. You may also want to change 
your disk drive cable, for that could have 
gotten soaked with salty water too. causing 
corrosion at the connectors either where 
they connect to the disk drive or where they 
connect to the wires of the cable itself. Note 
that merely rinsing a circuit board in water 
then drying that off will not normally harm 
the board or any component on it. 

MPI Cartridge Removal 

^^k I understand that inserting and re- 
^^ l moving cartridges from the CoCo's 
cartridge port while the power is on is 
dangerous. But is it also dangerous to in- 
sert or remove a cartridge from a slot in the 
Multi-Pak Interface if that slot is not cur- 
rently selected? 

Joe Sannucci (SANNUCCl) 
Elizabeth. New Jersey 

A Actually. Joe. it is more dangerous to 
insert or remove a cartridge from the 
Multi-Pak when the power is on than it is to 
do so with the CoCo system port itself. This 
is true regardless of whether or not the slot 
in question is selected. Slot selection on the 
Multi-Pak involves switching three data 
lines (the *CART interrupt, the *CTS ROM- 
select line, and the *SCS I/O port address- 
decode line) among the four slots. The 
selected slot sees active signals from these 
lines, and unselected slots constantly see 
inactive signals. (In the case of *CART. 
unselected slots are unable to transmit a 
signal back to the CoCo. ) But full power is 
being delivered to all lines on all slots of the 
Multi-Pak regardless of which slot is se- 
lected. Worse, while the CoCo 2 and 3 do 
not use pins 1 and 2 for anything, the Multi- 
Pak supplies + i 2 and -12 volts, respectively, 
on those pins. Right next to those two pins 



are the HALT and NMI lines, which go straight 
to the 6809 CPU without even being buffer- 
red. A jiggled cartridge can easily short +12 
or -12 volts right into the 6809, frying it for 
good. Don't do it! 

A Helping Hand with Lowercase 

^^k You were asked in a past installment 
^R. o) "( o( ot ' i .illations" how to use 
true lowercase on a CoCo 2B with OS-9. You 
confessed ignorance of how to do this. 
Here's how: Enter 

xmode /term type=l 

This comes. I should add. straight from the 
OS-9 Level I V2.0 addendum. 

Kent Bickley 
Salt Lake City, Utah 

A Yes, my ignorance of OS-9 was show- 
ing. You are one of about a dozen 
folks who have contacted me. both by mail 
and in person at the recent Chicago RAIN- 
BOWfest. to point out my error. Thanks! I 
will, however, stand by my "overview" 
position that it is a waste of time to run 
OS-9 Level I when the far-more-capable 
Level ll and CoCo 3 are so inexpensive. 

Recommendations 

• I've seen you quote me as recom- 
mending use of74F-series data buff- 
ers in Multi-Paks. That recommendation is 
not quite accurate. It is true that I have used 
74F245 chips to solve problems encountered 
with 74LS245 data buffers in a product of 
mine (a buffered Y cable adaptor). How- 
ever. I've found that not all brands of74E- 
series chips work correctly. 74F245 chips 
made by Fair child and NEC seem to work 
OK, but others do not. All 74AS245 chips 
work right, although, as do all 74LS645 and 
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74ALS645 chips. So I suggest you change 

your recommendation to CoCo users who 

want to replace the data buffers in their 

CoCo 3's and Multi-Paks to encouraging 

them to use the 74AS245, 74LS64S or the 

74ALS645. Note that the 74645 chips are pin- 

for-pin replacements for the 74245 chips. 

Bruce Isted (BRUCEISTED) 

Calgary. Alberta 

Canada 

HI)S Jumper Settings 

d^^ I own an IIDS floppy-drive i ontroller 
^m\.f or which I have lost my documenta- 
tion. It has two EPROM sockets, one for a 24- 
pin chip and the other for a 28-pin chip. The 
28-pifl socket is associated with a number of 
jumpers allowing it to be configured for 
6X766, 2764, or 27128 EPROMs. How do I set 
these jumpers? 

Zack Sessions (ZACKSESSIONS) 
Castle Hay ne. North Carolina 

A The three staking pins, labeled A, B 
and C. select which of the two sock- 
ets is selected. When Pin B is jumpered to 
Pin A. the 24-pin ROM socket is selected. 
Jumpering Pin B to Pin C selects the 28-pin 
socket. Socket A accepts only Tandy-style 
24-pin ROMs or 68766-type (8K-by-8) 
Motorola EPROMs. Pins D. E. F. G. H. I. J 



and K are used to configure the 28-pin 
socket to accept differing types of ROMs 
and EPROMs. If you plan on using a 2764 or 
27128 chip, you should use jumpers to join 
pins H and G. pins F and E. and pins J and 
K. If you want to use the 28-pin socket with 
a 24-pin chip, you must set the jumpers so 
that G and F are joined. E and D are joined, 
and I and J are joined. In summary, use the 
following jumper settings: 

27128 and most 2764 chips: 

— H-G, F-E, J-K 

24-pin ROMs and EPROMs: 

— OF. ED. 1-J 

HDS 2764 setting: 

— H-G. F-E. I-J 

CM-l Meets the Amiga 

Jlk lhavi acquired a CM-l monitor from 
^5J Radio Shack and was wondering 
whether it can be used with a Commodore 
Amiga? 

Robert Lang (WOODMAN) 
West Orange, New Jersey 

A The CM-l is a very strange monitor 
and. as it stands, cannot be used with 
any standard video protocol on any com- 



puter currently made. It was designed for 
use only wilh the Tandy 2000, or with PC- 
compatibles if used with one of two Tandy 
video boards: 25-3047 and 25-4037. With the 
25-3047. the CM-l can be used as a CGA 
monitor with a PC-compatible, although with 
higherquality (EGA-quality) text in the CGA 
text modes. The 25-4037 board allows the 
CM-l to be used with a PC-compatible and 
display EGA resolution graphics, although 
it still cannot display more than a total of 14 
colors and black and white. Neither of these 
two Tandy video boards are available now. 
The CM-l syncs at 25 KHz horizontal fre- 
quency, so it cannot be used with a CoCo, 
Amiga or Atari ST whose RGB video re- 
quires horizontal sync of 15.75 KHz. Its video 
luminance inputs are like that of an IBM CGA 
monitor (R. G, B and I). It is remotely 
possible that a CM-l could be made to sync 
with an IBM-style EGA video signal, al- 
though you'd likely have to play a bit with 
its horizontal sync circuit, and without 
adding special chips for video input decod- 
ing, still would get only six colors plus 
black and while. 

Getting Burned 

M^^ / recently purchased mi Intronics 
^d. Version 6 eprom programmer for 
the Color Computer and am having trouble 



JWT Enterprises 



Attention! MM1 programmers wanted. Many prospective 



Optimize Utility Set 1 NEW! 

Optimize your disks by eliminating fragmented files and compacting your 
directories for faster flic access. Also includes a utility to assess file fragmenta- 
tion and directory fragmentation as well as excess directory padding. 

Optimize Utility Set 1 $29.95 Foreign postage, add S3.00 



Nine-TimCS: Kach Issue contains: 9 helpful and useful programs to help 
build your OS-9 library ■ Instructions, examples, and samples of Basic09 
procedures and subroutines to help with your own programs and your 
understanding of Baslc09 * C programs and programming examples • Hints. 
Help columns, and Informative articles to advance your knowledge of OS-9 " 
Supplied totally of 5.25" disk ■ IJound manual sent to each new subscriber for 
help in getting Nine Times up and running, as well as tips on using it with a ram 
disk or hard disk " All graphic/Joystick Interface for ease of use. 

1-Year Subs, $34.95 Foreign postage, add $8.00 



Hack Issues: Available for the May 19S9 through May 1991 lssuca. Mease 
write for Information on Back Ikfiuc contents. 

Back Issue, ea. $7.00 Foreign postage, add $2.00 ea. 



Magazine Source: Due to many inquiries, the source code for the 
magazine graphic shell Is being provided as an Informational tool. Included Is 
the actual Basic09 source code and compiled modules on disk, as well as 
documentation and a printed copy of the source code. 



Source, $25.95 



Foreign postage, add $5.00 



Foreign postage excludes ll£. Territories and Canada. New rates eff. May 3 1. 1991 

To order, please send u.s. JWT Enterprises /^^^V 

5755 Lockwood Blvd. ffrvkl 

Youngstown, OH 44512 RAINBOW 

Mtpn&Ufot L*t*t20S9 stAl 

Sorry, no C.O.D.'a or credit cards: Foreign A Canadian ordem. please use U.W. aaomay orders. 
U.S. checks, allow 3-4 weeks for receipt of first issue/back Issue. 

Copyilajftl iCl 1»*1 OS-» it ■ Ifilmrl ft Hkfwin Sy.» — « Ceip »"■ Koiorota. If 



check or money order to: 



Technical As*>lsta.nci 

(2 16) -758-7694 
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Oblique Triad 

• Dam Marbles (512k) $31.95 

• Seventh Link $37.95 • 

•Caladuril II $32.95 ' 

•Overlord $28.95 \ 

•Caladuril $19.95 . 

• 

Sundog 

•Crystal City $34.95 • 

•Zenix $29.95 • 

•Quest tor Thelda ©12k) $34.95 J 

• Kyum-Gai (reg.) $29.95 , 

•Sinistaar (512k) $34.95 . 



• Kyum-Gai $29.95 

• Pertascil $19.95 

• Variations of Solitaire . $34.95 

NEW 1 Pyramid. Klondike. Spider. 
Poker, & Canfield. all in one 
package! Mvue NOT requiredl 



(PRO! 



Buy any item on this page ' 

before Nov. 15, and get a ' 

surprise gift from our slock! ' 

i 

visa/mc orders 1 .800.937.t746 ' 

all other calls 1 .31 3.461 .3263 . 

p.o box 763 ypsilanti ml 48197 a 



Include WSSH on of US Oldin.SS CON. COD S) ooaMnot VSA/MC odd SV 
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hading the file eprom . b i n that I created for 

burning an Extended ADOS-3 EPROM. Can 
you help me? 

Tom Lucas (TOMLUCAS) 
La Grange. Illinois 

A Back when I was familiar with ihe 
Intronics EPROM burners for Ihe Color 
Computer, the buffer for the EPROM started 
at address $2000. The file. EPR0M.BIN. cre- 
ated by Extended ADOS-3 is designed to load 
into the computer starting at location $4000 
in memory. Thus, assuming that Version 6 
of the Intronics burner puts its buffer where 
the earlier versions did (check your docu- 
mentation on this) your problem may be 
solved by offset loading the EPR0M.BIN file 
so it loads $2000 bytes lower in memory than 
it normally would. This is done by loading 
it using the command 

LOADM "EPROM. BIN". &HE000 

If you*re using a tape system, substitute 
CLOADM for LOADM. 

The Disk-to-Modem Connection 

4^k Is then to connect the Direct 

^K, Connect Modem Pak to my disk drive 
so I can upload and download software to 
the drive? Can I use the Direct Connect 
Modem Pak with DeskMate.'' 

Pete Fansler (ROBERT 19 1) 
Chattanooga. Tennessee 

A To use either the (virtually worthless) 
DC Modem Pak or an RS-232 Pak with 
a Color Computer disk system, you need 
either a Multi-Pak Interface, a Slot Pak. a Y 
cable or some equivalent that allows you to 
put both the DC Modem Pak and the disk 
controller on the CoCo system bus. If you 
use a Y cable, you" II also need to disable the 
ROM inside the DC Modem Pak. I recom- 
mend you put the DC Modem Pak aside and 
instead use the 4-pin serial port on the Color 
Computer itself, in conjunction with an 
external modem. Later, if you like, you may 
want to get a Multi-Pak. a Slot Pak or a Y 
cable, and may decide to convert your DC 
Modem Pak into a general-purpose RS-232 
port, as per the article I wrote for the July 
1991 issue of THE RAINBOW. 

The BASIC Connection 

4^k How do I convert a BASH program 
^R written for the IBM Pt into one that 
can run on a CoCo? 

Robert Williams (bawiluams) 
Cedar Hill. Missouri 

AWhile both CoCo BASIC and GW-BA- 
SIC (for the PC) were written by Mi- 
crosoft, they differ in the way some com- 



mands work, how each handles text posi- 
tioning and graphics, and in what graphics 
modes are supported. You'll have to be 
very familiar with the details of both dia- 
lects of BASIC to translate programs be- 
tween them. Indeed, if the program uses 
text formatting on the screen, or graphics to 
any considerable extent, you may find 
yourself effectively having to rewrite the 
program virtually from scratch. If the pro- 
gram uses only a very simple text display, 
conversion is much more feasible. 

You should first save the program as an 
ASCII file on the PC. Then transfer the file to 
the CoCo by one of several methods: 1 ) Use 
a file-conversion program on the PC (Xeno- 
copy or CoCo Util) to write the file to a 
CoCo-readable disk; 2) Use my CoCo/MS- 
DOS utilities, available on Delphi and in the 
June and July 1986 issues of THE RAINBOW, 
to read a single-sided MS-DOS disk on the 
CoCo; 3) Use a null-modem cable and 
communications programs to transfer the 
file from the PC to the CoCo; or 4) Upload 
the file from the PC to your Delphi Work- 
space and use your CoCo to download it. 

Upgrading 

£^k 11 hat is the best wa) to upgradi my 
^^ wife's A Color Computer 2 with 
Color BASIC to 64K and Extended Color 
BASIC? Will the 4164s and Extended BASIC 
ROM from my CoCo I work in her CoCo 2? 
Keith Abbott (KEtTHABBOTT) 
Champaign . Illinois 

A Whether the 4164 DRAMs and Ex- 
tended Color BASIC ROM from your 
old CoCo 1 will work in your wife's CoCo 
2 depends on exactly which model of CoCo 
2 she has. The two earliest models of CoCo 
2 can be upgraded using the same 24-pin 
Extended BASIC ROM and the same 4164 
DRAMs that were used in a CoCo 1. Al- 
though you do have to know exactly which 
jumper to install to get it to use the bigger 
DRAM chips. Later-model CoCo 2's use 
two4464 DRAMs to upgrade to 64K (these are 
the same type DRAMs used in the 1 28K CoCo 
3) and use a single 28-pin ROM that has both 
Color BASIC 1.3 and Extended Color BASIC 
I . I in it. The memory upgrade on those later 
CoCo 2's does not require manipulating 
any jumpers, but the ROM upgrade requires 
moving five jumpers near the ROM socket 
from the 64K to the 128K positions. I give 
more details in my article on memory up- 
grades for the CoCo in the March 1989 issue 
of THE rainbow. Note that unless you can 
get the parts virtually free (as is the case for 
some hackers, although not for many CoCo 
owners), it might make more sense to just 
go out and buy a CoCo 3 while they are still 
available at the S99 closeout price. 



Repairing Disk Drives 

^^ / have a Qume inch, .W)K disk 
^K^ drive with a broken head. How might 
I go about repairing it so I can use it with an 
FD-502 drive setup? 

Robert Coates 
Sandy Hook. Maintoba 
, Canada 

A Don't bother attempting a repair! 5'A- 
inch. 360K drives should be consid- 
ered disposable these days, for they are 
obsolete in the world of the PC-compatibles 
and are available used at surplus dealers 
and swap meets for as little as SI0 to $25 
each. New. they can be had for $30 to $60. 
Any attempt to repair a broken drive will 
likely involve your having to own disk 
drive alignment systems costing $90 or more. 

Limiting Available Drives 

^^k What is involved in limiting the 
^^^ number of dri\ es ttst ith w m is-3 to 
two double-sided drives and the number to 
he used with OS-9 to three double-sided 
drives? 

Tom Thomas (TOMIIIOMAS) 
.lanesville. Wisconsin 

A The Color Computer disk controllers 
normally used (those made by Tandy. 
J&M. HDS and Disto) provide four drive- 
select lines. Of these, three are the normal 
Drive 0. 1 and 2 select lines. The line thai 
Tandy calls the Drive 3 select line is on Pin 
32. the line used by double-sided drives as a 
side-select line. Thus, under OS-9. which is 
quite capable of looking at a double-sided 
drive as a single drive, you cannot have 
more than three double-sided drives hooked 
up. for the fourth drive-select line must be 
used as a side-select line with the double- 
sided drives. Under ADOS, double-sided 
drives are accessed as if they were two 
virtual, single-sided drives. Each physical 
side of the disk in a double-sided drive is 
accessed as if it were a different drive 
number. Since Disk Extended BASIC pro- 
vides for no more than four drives, the 
maximum number of physical double-sided 
drives you can use under ADOS is two. for 
each of those will be seen as two virtual 
drives by ADOS. 

Hi-Res Interfacing 

^^ How do I use the Tandy Hi-Res Jo) s- 
^^^ tii klnterfai ■ in my BASIC programs? 
What codes am I to read? 

William Chamberlain 
Nashville, Tennessee 

A The Hi-Res Joystick Interface from 
Tandy requires the use of an assem- 
bly-language driver program. RAINBOW ran 
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an article on this by Steve Bjork ("CoCo 
Mouse." July through September 1986). the 
creator of the Hi-Res Joystick Interface. 
This article includes assembly-language 
source code you can use. Another article, 
by Duane Perkins (February 1988, Page 
122). provides a machine-language routine 
in the form of a BASIC program. 

Resisting Monitor Input 

^^k I read vour reports about the video 
™ " lines of the Tandy I mo CGA video 
output possibly damaging the CM-K's in- 
puts. So I put some resistors in series with 
the R . G and B lines to lower the voltages to 
the CM-x, and this seems to work cpiite 
nicely. Others may want to try this. 

Also, I noticed that my CoCo 3 power 
supply runs rather hot. What do yon think of 
putting a ISOma, 12-voltfan inside the CoCo. 
powering it off the voltage I obtain at each 
side ofa>2? 

Allan Kimmel 
Panama City, Florida 

A I like your idea of inserting some 
dropping resistors in series with the 
R.Gand B lines if trying touseaCM-8 with 
CGA-type video input. As for that fan. the 
power available from the CoCo's power 
transformer is quite limited, so I would not 



recommend powering it off any part of the 
CoCo"s power supply. Instead, power it off 
a 12-volt wall transformer. If you use power 
from the CoCo. the transformer may get too 
hot. for it is rated for a power output within 
about loo to 200ma of what it is delivering 
already. Adding an extra ISOma to its load 
does not seem to me like a good idea. 

Modem Pak Blues 

^^^ My modem software does not recog- 
^J^ nize my Direct Connect Modem Pak. 
What do you recommend? 

Robert Newharr 
Camden, New Jersey 

AVI'erm, DelphiTerm, and MikeyTerm 
all have provisions for operating with 
the DC Modem Pak (assuming you have a 
Multi-Pak Interface so you can use it with 
your disk drives, of course ). The documen- 
tation for those programs, if you have the 
latest version, tells you how to alter the 
programs for use with the DC Modem Pak. 
Alternatively, my article in the July 1991 
issue of THERAINBOW explains how to turn 
a DC Modem Pak into an RS-232 pack. You 
will also see how to alter the address of the 
DC Modem Pak so that your terminal pro- 
grams see it as an RS-232 pack addressed at 
SFF68 instead of SFF6C. 



Flaky CoCo 

^^k I have a -: ~k CoCo 3 that is acting a 
^^J little flaky. Sometimes it powers up 
as Disk Extended Color BASIC 2.1 and other 
times it powers up as Disk Extended BASIC 
l.l.lt tends to crash during disk access. It 
has a 42-ohm resistor soldered across R22. 
Any suggestions? 

Richard Davis 
Haverhill. Massachussettes 

A Try removing that resistor and clip- 
ping out C65 and C66. These are tiny 
little green capacitors, one found in front of 
the memory-chip area and one found be- 
hind the memory -chip area. 

Your technical questions are welcomed. 
Please address them to CoCo Consultations, 

THERAINBOW. P.O. BOX 385. Prospect, KY 40059. 

We reserve the right to publish only 
questions of general interest and to edit for 
brevity and clarity. Due to the large volume 
of mail we receive, we are unable to answer 
letters individually. 

Questions can also be sent to Marty 
through the Delphi CoCo S1G. From the 
CoCo sig> prompt, pick Rainbow Magazine 
Services. Then at the r.\im»ow> prompt , 
type ASK <for Ask the Experts) to arrive at 
the EXPERTS> 

prompt , where you can select the "CoCo 
ConsultaUons"oniine form, which has com- 
plete instructions. 
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Kyum-Cai: to be Ninja (05-9 Version) is the culmination of a project started almost a year 
ago. Hie talents of Glen ft Dahkjren (RS-DOS game writer lor Sundog Systems), Kevin 
Darling (a legend (or his work in OS-9), and Eddie Kuns (author of KBCom) have been 
pooled to create a masterpiece ot game software under the OS-9 operating system. Fast 
martial arts action with outstanding graphics, great digitized sound effects, and incredible 
animation are featured in this arcade game, all in the OS-9 environment. 

Always wanted to play the great CoCo 3 games but didn't want to sacrifice your OS-9 
features? Multitask while playing Kyum-Cai. Have multiple Kyum-Gai's running in 
memory. Don't worry about switching windows, because Kyum-Cai: OS-9 auto-pauses, 
to wait for your return. 

Put simply, this is an unprecedented piece of software for the CoCo; a landmark game sure to be 
a major part of the Color Computer history Don't miss out on this game! ^ "lQ C%C 
Req. 51 2K CoCo III with OS-9 Level 2 and joystick. ^L^/.^O 



VISA, Mastercard, Money Order, and 
COD (USA only, please) accepted. All 
foreign orders must be sent In US cur- 
rency Money Orders. Include $2.50 for 
shipping in USA and Canada, $5.00 
Foreign. S3. 00 extra for COD orders. 
VA residents please add 6% sales tax. 
Dealer Inquiries welcome. Authors: we're 
looking for new software! 
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P.O. Box 766 

Manassas. VA 22111 

(703) 330-8989 
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October 5-6, 1991 

Holiday Inn Northlake 




Once again, 
CoCoPRO! invites 
you to join with 
hundreds of fellow 
CoCo/OS-9/OSk fans 
for 2 days of fun in 
the sunny South, at the 

Atlanta CoCoFEST! 

Come enjoy the "Southern hospitality" 

of the Atlanta Computer Society.. .and while 

you're enjoying that, you can also enjoy: 

♦ informative seminars from the "gurus" of CoCo, OS-9, & OSk, such as 
Kevin Darling. Chris Burke. Keith Alphonso. Ed Hathawav. & otters.' 

♦ Exhibitions and special show prices from your favorite vendors! 

• Introductions of innovative SEW products for CoCo/OS-9, and OSk! 

• Demonstrations of the much -discussed, new "CoCo-4's"! 



As last year's show SOLD OUT the hotel, we are accepting reservations a bil earlier this year. 
Although there are other hotels nearby, you can enjoy the convenience of staying onsite at the 
special rate of $49/nitc *• tax (total $53.90). single or double. Also, you can save $5 per ticket by 
ordering now at the presale price of S12 for One-day. or $15 for a Full-show pass! 



PRO! 



P.O BOX 763 YPSILANTI Ml 48197 



Include SI S&H on *■ SckM 

COO H additional. 



VISA/MC ORDERS 1 .800.937.7746 

iTOUCHloNi PWO*t REQUIRED) 

ALL OTHER CALLS 1.313.481.3283 
laPMESTMON-gAT 



n urn onto. tkkvte. ptat. .•Hr.tboo.. o. cntar 
m CoCoPRC. mnucl. b, uSm -HS.1 11131292471] 
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novices Niche 




Cable TV 

by John Norris 



Do you find yourself continually 
wrestling with the local cable listing to 
figure out which station is on which chan- 
nel? If so. this short program may he able 
to assist you in quickly locating those 
hard-to-find stations. Cable T\ prints a 
small, two-column listing of all the local 
cable channels, using the DMP-130's Mi- 
crofont. The listing can be taped to the 
back of most remote controls. 

The program currently prints a list 
of the cable channels in 



Home Help/4K Standard 




The Listing: CABLETV 



1 'CABLE TV 

2 'WRITTEN BY JOHN NORRIS 

3 'COPYRIGHT 1991 FALSOFT. INC. 
10 PRINT#-2.CHR$(27):CHR$(77) 

20 PRINT#-2."2 BALT 21 MA 



my area, so substitute the cable channels 
for your area in lines 20 through 30. You 
may also add more than 3X channels to the 
listing, although the limitation depends 
on the size of your remote control. The 
printer control codes in Line in set the 
Tandy DMP- 130a printertoMicrofont. For 
other printers without Microfont. try us- 
ing super- or subscripts and change the 
linefeed to reduce the vertical size of the 
channel listing. 



X" 

21 PRINT#-2."3 20 WASH 
C" 

22 PRINT#-2."4 WASH 
T" 

23 PRINT#-2."5 WASH 
R" 

24 PRINT#-2."6 WASH 
S" 

25 PRINT#-2."7 WASH 
PN" 

26 PRINT#-2."8 MEU 
N" 

27 PRINT#-2."9 WASH 
N" 

28 PR1NT#-2."10 45 BALT 
ATHR" 

29 PRINT#-2."11 BALT 
SHOP" 

30 PRINT#-2."12 MPT 



A Color Doodler 

by Keiran Kenny 

With Color Doodler. you can draw 
lines, of any length and at any angle, in 15 
different colors anywhere on the screen. 
Press 2 on the menu screen to start a new 
picture. On the next screen a color bar is 
drawn with colors labelled through 9 
and A through F. representing the 16 
palette registers. Colors through 7 are 
the default colors for those slots. Colors 8 



Graphics/CoCo 3 



31 PRINT#-2."13 BALT 32 WH 
MM" 

32 PRINT#-2."14 54BALT 33 DS 
C" 

33 PRINT#-2."15 HBO 34 AS 
E 

34 PRINT#-2."16 SHO 35 LI 
F" 

35 PRINT#-2."17 DIS 36 TN 
N" 

36 PRINT#-2."18 HTS 37 AA 
SCHL" 

37 PRINT#-2."19 JONES 38 NI 
K" 

38 PRINT#-2."20 TMC 39 FA 
M" 
41 END 




through F are poked into palette registers 
s through 15 by the routine in lines 80 and 
90. (These colors are intended for an RGB 
monitor.) Press any key and a green flash- 
ing cursor is shown at screen center. Press 
a color key, to E. to change the color. 
You cannot select F (black ). Black is used 
only for the background color and the 
eraser (Line 530). 



The movement keys are: The arrow 
keys: W for northeast: S for southeast; 
ALT for northwest and CTRL for south- 
west. You can start drawing at the screen 
center, or move your cursor if you want to 
begin elsewhere. A single lap on a move- 
ment key sets the cursor moving in the 
chosen direction. To change direction, 
press another movement key. To stop the 
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cursor movement temporarily, press any 
key except a movement key or a function 
key — I recommend the spacebar. If the 
cursor is moving diagonally, it stops when 
it reaches a screen boundary and remains 
there until you move it along or away 
from the boundary. 

The function keys are: F2 to draw your 
line: N toerasethe last line: Ptosaveyour 
picture: H to see the color bar: and CLEAR 
to end the program. Line KM) disables the 
BREAK key while you are drawing. 

To draw a line, press a color key and 
then press Fl to mark the beginning of the 
line. Move the cursor, and when it is 
where you want the line to end. press F2. 
You can move the flashing cursor across 

The Listing: CLRDUDLR 

'A COLOR 000DLER 

1 'WRITTEN BY KEIRAN KENNY 

2 'COPYRIGHT (C) MAY 1991 

3 "BY FALSOFT, INC. 

4 "RAINBOW MAGAZINE 
MCL(500).H1(500).V1{500).H2 
.V2(500) 
PEEK(&H15F)=196THENDV-1ELSE 

S:PRINT@160."YOU CAN:":PRIN 
1 LOAD A SAVED PICTURE. 



10 Dl 
(500) 
20 IF 
DV--1 
30 CL 
T@227 



or along existing lines, but if you erase 
a line, you will cut gaps in any lines the 
eraser crosses. If you press H while you 
are drawing, the color bar will be super- 
imposed on the screen like a window. 
Press a color key to choose a color, or 
press any other key (except a move- 
ment or function key) to restore the 
graphic screen with the last chosen color 
unchanged. 

As you draw each line, the values for 
i ts color ( C L ) and i ts parameters ( H 1 , V 1 , 
H2 and V2) are stored in arrays. In Line 
10 the program dimensions enough 
space for 500 lines. The variable NR in 
Line 510 keeps the line count. When 
your picture is complete, or if you want 



R":PRINT@291."2 DRAW A NEW PICTU 

RE." 

40 K$-INKEY$: I FK$<>"1"ANDK$<>"2" 

THEN40 

50 IFK$-"1"THENLD=1 : CLS : PRI NT@22 

4.""::LINEINPUT"L0AD FILENAME: " 

:F$ 

60 POKE65497.0 

70 PALETTERGB 

80 F0RSL=8T015:READPL:PALETTESL. 

PL:NEXT 



to take a break, press P. The routine in lines 
620 to 720 saves the arrays to tape or disk and 
ends the program. If you have a disk drive 
plugged in. the arrays are saved to disk, 
otherwise to tape. Line 20 establishes the 
device value. DV-1 or DV--1. accordingly. 

To load a saved picture, run the program 
and press I at the first screen. Then enter the 
filename. The load routine is in lines 230 to 
320. When you load a picture, the cursor is 
set at the end of the last line loaded onto the 
screen. You can then select a color, add lines 
to your picture and save it again. 

If you use ADOS-3. you"ll need to make a 
couple of minor changes to Color Doodler. 
In Line 4S0, change ix<> to 23. In Line 500, 
change 103 to 226. 



90 DATA 24.33.40.43,48.52.56.0 

100 P0KE41598.255 

110 HSCREEN2:HCLS15 

120 A$-"0123456789ABCDEF- 

130 HBUFF1.2552:HBUFF2.2552 

140 B$="*C0L0R D00DLER*":B-9:CL= 

0:FORT-1TO15:HCOLORCL:HPRINT(B.3 

).MID$(B$.T.1):B=B+1:CL-CL+1:NEX 

T 

150 C$-"by Keiran Kenny" : B=9:CL- 

0:FORT-1TO15:HCOLORCL:HPRINT(B.5 



m®$ 



EVERYONE'S TALKING ABOUT- 
DUAL HI-RES JOYSTICK ADAPTER 
Colorware Hi-Res Tandy Hi + Low 
Res, cassette jack S40 

HI ft L0-RES JOYSTICK ADAPTER 
Tandy Hi + Lo-Res S27 

HAWKSoft keyboard cable S25 

DOMINATION war game S18 

MYDOS extended DOS for you! S15 

H^WJCSoft 

P.O. Box 7112 Elgin, II 60121 

(708) 742-3084 eves and ends 

SASE for more info and price list. 

S/H ( US ft* CAN ) always included 

M.0. Check C.O.D. no credit cards 

1 year warranty on ALL hardware !! 




P.O. Box 733 Maple Valley, WA 98038 

U.S. ORDER DESK: (800) 237-2409 
INT'L & TECHNICAL: (206) 432-1814 



Whether it means next -generation B809 

machines, or the exciting power of the B8000. 

ii nu can count on new and useful Color Computer 

products from Burke St Burke I 

OS9 Software (* >= 256K; ** >= 51 2K required): 

WORLD CLASS CHESS* - Use Cyrus Chess w/ Level 2 S29.95 

FILE SYSTEM REPACK 1 .1 -- Faster disk defragmenter S29.95 

FILE RECOVERY SYSTEM -- Helps rebuild crashed disks S24.95 

R. S. B.* -- Disk BASIC for Level 2 (BASIC ROM required). S39.95 

EZGEN 1.09 - Handy & powerful OS9 bootfile editor S19.95 

CYBERVOICE (S/W only)" - Use SuperVoice w/ Level 2 S24.95 

PERTASCII* -- Multi-user scrambled letter word game. SI 9.95 

WILD & MV - Wildcard & move directory entry utilities S19.95 

ZCIock -- Continuous time/date display on Level 2 screen S9.95 

Affordable Color Computer Hardware: 

COCO XT - Use PC hard drive w/ CoCo I OS9 S/W Incl. S69.95 

COCO XT-RTC - CoCo XT, plus H/W real-time clock. S99.95 

XT-ROM -- Boots OS9 from B&B hard disk automatically. S19.95 

4 Hard disk cable set (Twice as long as standard cables!) S17.50 



WA RESIDENTS ADD 8.2% SALES TAX . 

MasterCard & VISA accepted. U.S. CODs add $3.75. Min. U.S. 

shipping $4.00. Min. to Canada $5.00. Please allow 2 weeks for 

deliver}'. Overnight or 2nd- day available for in-slock items. 
Software upgrades $5.00 each w/'receipt, including U.S. sliipping. 
Call or write for our free catalog! 
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).MIDJ(C$.T.1):B-B+1:CL-CL+1:NEX 
T 

160 HCOLOR0:HPRINT(11.9)."YOUR C 
OLORS:" 

170 HLINE(14.87)- (264.103) .PSET. 
B 

180 B-2:F0RT=1T016:HPRINT(B.11). 
MID$(A$.T.1):B-B+2:NEXT 
190 CR=0:FORL-15TO263STEP16:HCOL 
ORCR:HLINE(L.96)-(L+8.102).PSET. 
BF:CR-CR+1:NEXT 
200 HGET(14.87)-(264.103).l 
210 HCOLOR0:HPRINT(10.14)."PRESS 
ANY KEY"::EXEC44539:K$-INKEY$:H 
CLS15 

220 IFLD-0THEN330 
230 POKE65496.0 
240 OPEN"I".#DV.F$ 
250 INPUT//DV.NR 
260 FORZ-ITONR 

270 INPUT#DV.CL(Z).H1(Z).V1(Z).H 
2(Z).V2(Z) 

280 HC0L0RCL(Z):HLINE(H1(Z).V1(Z 
))-(H2(Z).V2(Z)).PSET 
290 X-H2(Z):Y-V2(Z) 
300 NEXTZ 
310 CLOSEffDV 
320 POKE65497.0:GOTO340 
330 X=160:Y-96 
340 PK=PEEK(135) 



350 IFPK=80THEN620 

360 IFPK-72THENHGET(14.87)-(264. 

103).2:HPUT(14.87)-(264.103).1:E 

XEC44539:HPUT(14.87)-(264.103).2 

370 IFPK>47ANDPK<58TH£NK=PK-48:H 

COLORK ELSEIFPK>64ANDPK<70THENK- 

PK-55:HC0L0RK 

380 IFX=0AND(PK-189ORPK=64)THENP 

OKE135.0:GOTO340 

390 IFX-319AND(PK=870RPK-83)THEN 

POKE135.0:GOTO340 

400 IFY=0AND(PK-64ORPK=87)THENPO 

KE135.0:GOTO340 

410 IFY-191AND(PK=1890RPK-83)THE 

NPOKE135.0:GOTO340 

420 IFPK-94THENY-Y-1 

430 1FPK-10THENY-Y+1 

440 IFPK=8THENX=X-1 

450 IFPK-9THENX-X+1 

460 I FPK-64THENY-Y-1 : X=X - 1 

470 I FPK-87THENY-Y - 1 : X-X+l 

480 IFPK=189THENY-Y+1:X-X-1 

490 IFPK=83THENY-Y+1:X-X+1 

500 IFPK-103THENH1-X:V1-Y:HSET(H 

1. VI) 

510 IFPK=4THENH2-X:V2-Y:HLINE(H1 

.V1)-(H2.V2).PSET:NR-NR+1:CL(NR) 

-K:H1(NR)-H1:V1(NR)-V1:H2(NR)=H2 

:V2(NR)=V2:POKE135.0 

520 IFPK-12THEN610 



530 IFPK=78THENHC0L0R15:HLINE(H2 
.V2)-(H1.V1),PSET:NR-NR-1:HC0L0R 
CL(NR):X-H1:Y=V1:POKE135,0 
540 IFY<0THENY-0 
550 IFY>191THENY-191 
560 lFX<0THENX-0 
570 IFX>319THENX-319 
■580 BG=HPOINT(X.Y) 
590 HSET(X.Y):FO«DL-1TO100:NEXT: 
HSET(X.Y.BG) 
600 GOTO340 

610 POKE65496.0:POKE41598.3:RGB: 
W1DTH32:CLS:END 
620 POKE135.0 

630 POKE65496,0:POKE41598.3:RGB: 
W1DTH32-.CLS 
640 PRINT@224.""; : LINEINPUT"SAVE 

FILENAME: " : F$ 
650 OPEN"0".#DV.F$ 
660 PRINT#DV,NR 
670 FORZ-1TONR 

680 PRINT#DV.CL(Z).H1(Z).V1(Z).H 
2(Z).V2(Z) 
690 NEXTZ 
700 CLOSE//DV 

710 CLS:PRINT@224."FILE "F$" SAV 
ED" 
720 END 



Vocabulary Aid 

by Keiran Kenny 



Vocabulary Aid presents a hands-on 
approach through which you can learn 
correct word spellings and definitions. 
Words can be selected to match the user's 
level. Lines iihkj through 2000 contain 
some fairly difficult examples. In each 
line, the first item is a word and the 
second item is the meaning (for example. 
1109 DATA MONUMENTAL. VERY LARGE). 
Notice how the DATA statements are placed 
in four groups. The first group in lines 
1000 through 1010 contains 10 words and 
ends with an empty entry (1010 DATA 
"".""). The second group in lines lioo 
through 1 1 10 also contains 10 words. The 
third group in lines 1200 through 1204 
contains four words, and the fourth group 
in Line 20(H) contains only an empty entry. 
An empty entry is used to end all four 
groups. 

The Listing: V0CABLRY 

1 'VOCABULARY AID 

2 'WRITTEN BY KEIRAN KENNY 

3 'COPYRIGHT 1991 FALS0FT. INC. 
10 CLS 

20 DIMA$(11).B$(11) 

30 P=0 

40 F0RT-1T011:READA$(T).B$(T):IF 

T=1ANDA$(T)=""THEN340ELSEIFA$(T) 

-""THEN50ELSEPRINT@P,A$(T)": "BS 



Spelling Helper/1 6K Standard 



When you run the program, the in 
words and meanings from the first group 
arc displayed. Press the space bar when 
you are ready, and a randomly selected 
meaning from the first group is displayed 
with the associated word displayed be- 
low it. However, notice that every other 
character in the word is replaced with an 
asterisk (*). Your job is to determine 
which word fits the pattern and replace 
the asterisks with the appropriate letters. 

Il may look easy, but you may have to 
consciously spell each word as you type 
or you can easily make mistakes. This, in 
itself, can further reinforce the process of 
learning the correct spelling of the words. 
After each word, follow the prompt and 
press any key for the next word. 

When you finish all 10 words in the 
first group, the in words in the second 



(T):P-P+32:NEXT 

50 T=T-1:PRINT:PRINT"READ THESE 

WORDS AND THEIR MEAN-INGS. AND L 

EARN TO SPELL THE WORDS. PRES 

S THE <SPACEBAR> WHENY0U ARE REA 

DY FOR A TEST." 

60 K$=INKEY$ 

70 K$-INKEY$:IFK$OCHR$(32)THEN7 

0ELSECLS 



group are shown. This group is played in 
the same manner as the first group of 
words. After this, the four words in the 
third group are shown. When you finish 
these four words, the total number of 
words from all of the groups is shown 
along with the number of correct re- 
sponses. 

You can add as many words and 
meanings to the groups as you choose. 
Although you can create any number of 
groups, limit the number of words in each 
group to a maximum of Id. Also, use only 
single words without hyphens or apostro- 
phes because the typing routine in lines 
190 through 2W) responds only to the let- 
ters A through Z. Don't forget to include 
a null word and meaning pair as the last 
entry in each group. 



80 F0RX=1T0 T 

90 PR1NT@32."THIS WORD MEANS:" 

100 R-RND(T):IFB$(R)-""THEN100EL 

SEPRINT@112-LEN(B$(R))/2.B$(R) 

110 B$(R)="" 

120 F0RL-1T0 LEN(A$(R)) 

130 IFL/2-INT(L/2)THENC$="*"ELSE 

C$-MIDJ(A$(R).L.l) 

140 D$=D$+C$ 
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150 NEXT 

160 P=176-LEN(D$>/2 
170 PRINT@P.D$: 
180 PRINT@451 ."TYPE T 
LETTERS." 

190 F0RPL-1T0LEN(D$) 
200 E$-MID$(D$.PL.l) 
210 IFE$O"*"THEN240 
220 K$-INKEY$:IFK$-"" 
$>"Z"THEN220 
230 PRINT@P.K$::E$=K$ 
240 F$-F$+E$ 
250 P-P+l 
260 NEXT 

270 IFF$=A$(R)THENR$-"RIGHT! 
-RT+1ELSER$-"S0RRY!" 
280 R$=R$+" "+"IT WAS "+CHR$(34> 
+A$(R)+CHR$(34)+"." 
290 PRINT@240-LEN(R$)/2.R$ 
300 PRINT@451, "PRESS ANY KEY." 
310 EXEC44539:CLS:D$="":F$-"":NR 
-NR+1:K$-INKEY* 
320 NEXT 
330 CLS:GOTO30 

340 CLS:PRINT@138."END OF TEST" 
350 PRINT@195."Y0U HAD"RT"RIGHT 
OUT 0F"NR;CHR$(8)"." 
360 PRINT0257. "PRESS r TO REPEAT 
OR e TO END." 
370 K$=INKEY$:IFK$=""THEN370 
380 IFK$="R"THENCLS:RUN 
390 IFK$-"E"THENCLS:END 
400 GOTO370 

1000 DATA SUFFICIENT. ENOUGH 

1001 DATA LETHARGY. LACK OF ENERG 





Y 

1002 DATA 




1003 DATA 


HE MISSING 


1004 DATA 




1005 DATA 




1006 DATA 




1007 DATA 




1008 DATA 


ORK$<"A"ORK 


1009 DATA 




1010 DATA 




1100 DATA 




1101 DATA 




1102 DATA 




1103 DATA 


"RIGHT!":RT 


1104 DATA 



MATURE. GROW UP 
TENEBROUS. DARK 
MULTITUDE. CROWD 
NARRATIVE. STORY 
INDEPENDENCE. FREEDOM 
INFANTILE. CHILDISH 
INDIGNATION, ANGER 
NAUSEATING. SICKLY 

OBLITERATE. WIPE OUT 
NOURISHMENT. FOOD 
PROCRASTINATE. DELAY 
SHUFFLE. MIX 
SUPERFLUOUS. MORE THAN 



ENOUGH 

1105 DATA 

1106 DATA 

1107 DATA 
ED 

1108 DATA 

1109 DATA 

1110 DATA 

1200 DATA 

1201 DATA 

1202 DATA 

1203 DATA 

1204 DATA 
2000 DATA 



REQUIREMENT. NEED 
MILITARISTIC. WAR LIKE 
QUADRILATERAL. FOUR SID 

MONUMENTAL. VERY LARGE 
HIRSUTE. HAIRY 

GIGANTIC. VERY LARGE 
DIMINUTIVE. SMALL 
EXECRABLE. BAD 
DISEASED. SICK 



Playtime/CoCo 3 



Indians 

by Ruth E. Golias 

Indians is a musical program thai plays 
the song "Ten Utile Indians." After you 
run the program, a picture is drawn on 
HSCREEN2. and the words to the song are 
displayed while the music is played. (Can 
you find the other nine indians?) 

This program is designed for use with 




♦EXTENDED* 
ADOS-3 

• Built-in RAMdisk * Point-and-pick file select menu * 

Not a new version of ADOS-3. but a new product that shares space with ADOS-3 in 
a 16K EPROM Arrow-key selection of hies to execute LOAD COPY KILL or 
SCAN Trie BACKUP command is doubted in speed lo* full disks proportionately 
faster for partly full disks (BACKUPS to or from the RAMdisk typically take 5 to 20 
sec ) • BACKUP-with-format • Wild-card COPY and KILL, with optional prompting 
for individual files • Date (or date'time with hardware clock) displayed for files in 
the directory printed on LLISTmgs • DATES function • Key repeat • Block 
move/copy of BASIC program lines • Text screen printer dump • Auto-reboot of a 
BASIC program or the DOS command • Parallel printing • Read'wnte'format 35'40 
tracks on 80-track drives • Supports 3 double-sided drives plus 2 RAMdnves • 
Allows different numbers of tracks on different drives • Shares the original's excel- 
lent compatibility with commercial software For 128K CoCo 3 with ADOS-3 (RAM- 
disk use requires 512KJ Includes information on having an EPROM burned (cost is 
S15) after configuring Extended ADOS-3 Disk. $29.95. Extended ADOS-3 plus 
ADOS-3. $49.95. Drivei for Disto real-lime clock S5. Adapter for controllers lacking 
28-pin socket. $10. SmartWatch real-time clock (Tandy 25-1033 equiv ). S35 (Drivers 
for Ext ADOS-3 and OS-9 included: usable in 28-pm socketed controllers or in 
Rompack $10). 



"...will blow your socks off... impossible lo give Extended ADOS-3 



anything other than a rave review." 



— Rainbow, October 1969. 



"Flawless, compatible operation with just about everything under 
the sun. ..by far the most USEFUL product ever devised for the 
Color Computer." _ CoCq CUpboard Sept/ Oct 1989. 



ADOS-3 (reviewed July 1987) 

Customize default startup message, colors, screen width, baud rate, step rates. 
processor speed, number of tracks (35. 40 or 80) Disk I/O and printing are reliaole at 
double CPU speed Extra commands such as FAST. SLOW. AUTO. RUNM. SCAN. 
CAT PRT ON'OFF Keystroke macros, arrow-key scroll through BASIC programs 
edit 'repeal of last command aulo-edit of error line. ML monitor, lots more Usable as 
a disk utility or in EPROM 1?8K Coco 3 EPROM-burning (cost is 515-20) informa- 
tion provided Disk $24.95. ADOS lor CoCo 1 and 2 Disk $14.95. 

FOR OS-9: Sm?rtWaicIjfeal-tirneclock with driver $29.95; In Rompack $39.95. 



SPECTROSYSTEMS/ 



11111 N. Kendall Dr. 
Suite A108 
Miami. FL 33176 
(305) 274-3899 



PLEASE ADD S2 SHIPPING • NO DELAY ON PERSONAL CHECKS 
WE CANNOT ACCEPT CREDIT CARDS 



New Super V.32 Zoom Modem 
12000 Baud 

from Granite Computer Systems 

Granite Computer Systems introduces the latest ZOOM 
TELEPHONICS MODEM - THE V.32 TURBO. This 
model features the V.32 standard with the addition of 
12000 Baud. (Yes - 12000 Baud - count the zeroes!) 
This modem also provides full compliance with the V.42/ 
V.42 bis standards - both error correction and data 
compression. Automatically uses the most effective 
combination of MNP 1-5 or LAPM protocols available on 
the current data link. With data compression, data 
throughput can approach a mind boggling 48000 Baud! 

This is the modem for which you have been waiting - all 

the great features of the 2400 baud v.42/v.42bis modem - 

now with full v.32 +. Zoom modems have been receiving 

top reviews - see MACUSER Jan 91 and PC 

MAGAZINE Mar 91 - this modem will receive the same 

enthusiastic reception. 

As seen at Chicago RainbowFest 1991. 

V.32 TURBO Price $499 

(plus s&h $7 - USA - $12 Canada) 
Orders must be prepaid or COD. VISA/MC accepted. COD is extra. 

Granite Computer Systems 

571 Center Road, Hillsboro, NH 03244 

Great Computer Stuff since 1981 (603) 464-3850 
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a composite monitor. II' you use an RGB 
monitor, replace Line :<> with the line 
listed below. These changes to the palette 
slots give a close representation to the 
original composite colors. 

20 HSCREEN2:PALETTE RGB:PALETTE 
0.24: PALETTE 1.34 -.PALETTE 2.0: PA 
LETTE 3.4:PALETTE 4.10:PALETTE 5 
.7:PALETTE 6.0-.PALETTE 7.2:PALET 
TE 8.0:PALETTE 9.55:HCLS0 

The Listing: INDIANS 



TEN LITTLE INOIANS 

BY 

RUTH E. GOLIAS 



10 GOSUB1130 

20 HSCREEN2:PALETTE CMP:PALETTE 

0.46:PALETTE 1.21:PALETTE 2.0:PA 

LETTE 3.7:PALETTE 4.45:PALETTE 5 

.32:PALETTE 6.16:PALETTE 7.1:PAL 

ETTE 8.62:PALETTE 9.3:HCLS0 

30 HC0L0R 7 

40 HLINE(0.140)-(320.192).PSET.B 

F 

50 A$="D12F1D15F3D1L10U1E2U12H2U 

3:R2U15L7D15R7:BL6D7G1D9F2D1L11U 

1E3U15;E1U16BU4F5:BR7E5D7;BU7U3G 

6L7:E3R1U1H1NG1E5H5G3F3G3NF2:BG4 

G9F2E6NE4G2:BU8BR3U1H7L1U3E9:B09 

D4NH2F3D1:BL1BU18NL1F1R7E1R1:F1R 

3F4D3F1D2F102G1D5: F1D3F1D1F1D1G1 

L5U5H2BU4U7" 

60 HDRAWBM100.150:C2:XA$:" 

70 HPAINT(98.153).1,2 

80 HPAINT(86.154).1.2 

90 HPAINT(95.153).2.2 

100 HPAINT(90.146).2.2 

110 HPAINT(78.151).2.2 

120 HPAINT(92.136).2.2 

130 HPAINT(92.126).1.2 

140 HCIRCLE(92.114) . 10.2. 1 . .38. . 

15 

150 HPAINT(90.114).1,2 

160 HDRAW"BM100.113:C2:H5L5D1G3L 

1:L3G4D2G2D4E3U1E1U1E1:BU3H4E4F3 

170 HPAINT(100.112).2.2 

180 HPAINT(80.117).3.2 

190 HPAINT(80.110).5.2 

200 HSET(96.114.4):HSET(90.114.4 

) 

210 HDRAW"BM94.118:C2:L2" 

220 HDRAWBM135 . 164 : S8 : C2 : E44NE4 

NU4NH4F44L29H15G15NR29L29" 

230 HPAINT(223.160).6.2 

240 HPAINT(237.100).5.2 




250 HDRAW"BM130.184;R5U1R2U2L7O1 

L1D1R1D1:BR15BU6R7U1R1U1L2U1L3D1 

L1D1L2D1:BR16BD4R4U1L1U1L2D1L1D1 

:BD4BR20R7U1R1U1L2U1L3D1L2D1L1D1 

:BR16BU6R5U1R3U2L8D1L1D1R1D1" 

260 HPAINT(132.183).9.2 

270 HPAINTC 168. 170) .9.2 

280 HPAINTC 196.178) .9.2 

290 HPAINTC241 . 186) .9.2 

300 HPAINT(270.175).9.2 

310 HDRAWBM20.174:R6U1R2U3L8D1L 

1D1R1D2" 

320 HPA1NTC22. 172) .9.2 

330 FOR D-l TO 500:NEXT D 

340 HC0L0R 6 

350 HPRINTC 1 .3) ."ONE LITTLE." 

360 PLAY"T3:V30:O2L4FL8FF" 

370 HSET(206.158.4):HSET(210.158 

.4) 

380 HPRINT(13.3)."TW0 LITTLE." 

390 PLAY"L4FL8FF" 

400 HSET(216.156.4):HSET(220.156 

.4) 

410 HPRINT(25.3)."THREE LITTLE " 

420 PLAY"L4A03L8CC" 

430 HPRINTC32. 5). "INDIANS." 

440 PLAY"02L4AF" 

450 HPAINT(0.24).0.2 

460 HSET(212.148.4):HSET(216.148 

.4) 

470 HPRINT(1.3)."F0UR LITTLE." 

480 PLAY"GL8GG" 

490 HSET(218.142.4):HSET(222,142 

.4) 

500 HPRINK 14.3) ."FIVE LITTLE." 

510 PLAY"L4GL8GG" 

520 HSET(222.139.4):HSET(226.139 

.4) 

530 HPRINT(27.3)."SIX LITTLE" 

540 PLAY"L4EL8GGL4EC" 

550 HPAINT(0.24).0.2 

560 HSET(224.147.4):HSET(228.147 

.4) 

570 HPRINT(1.3)."SEVEN LITTLE." 

580 PLAY"FL8FF" 

590 HSET(226.152.4):HSET(230.152 

.4) 

600 HPRINT(15.3)."EIGHT LITTLE." 

610 PLAY"L4FL8FF" 

620 HSET(230.161.4):HSET(234.161 

.4) 

630 HPRINTC29.3) ."NINE LITTLE" 

640 PLAY"L4A03L8CC02L4AF" 

650 HPAINT(0.24).0.2 

660 HPAINT(32.40).0.2 

670 HSET(232.155.4):HSET(236.155 
.4) 

680 HPRINT(1.3)."TEN LITTLE INDI 

AN BOYS." 

690 PLAY"03L4C02L8B-B-L4AGL2.F" 

700 FOR D-l TO 500:NEXT D 

710 HPAINT(0.24).0.2 

720 HSET(232.155.6):HSET(236.155 

.6) 

730 HPRINT(1.3)."TEN LITTLE." 

740 PLAY"L4FL8FF" 

750 HSET(230.161.6):HSET(234.161 

.6) 

760 HPRINTC 13.3) ."NINE LITTLE." 

770 PLAY"L4FL8FF" 

780 HSET(226.152.6):HSET(230.152 

.6) 

790 HPRINT(26.3)."EIGHT LITTLE" 

800 PLAY"L4A03L8CC" 

810 HPRINTC32. 5). "INDIANS." 

820 PLAY"02L4AF" 

830 HPAINT(0.24).0.2 



840 HSET(224.147.6):HSET(228.147 

.6) 

850 HPRINTC1 .3) ."SEVEN LITTLE." 

860 PLAY"L4GL8GG" 

870 HSET(222.139.6):HSET(226.139 

.6) 

880 HPRINTC 15.3) ."SIX LITTLE." 

890 PLAY"L4GL8GG" 

900 HSET(218.142?6):HSET(222.142 

.6) 

910 HPRINTC27.3) ."FIVE LITTLE" 

920 PLAY"L4EL8GG" 

930 HPRINTC32. 5). "INDIANS." 

940 PLAY"L4EC" 

950 HPAINT(0.24).0.2 

960 HSET(212.148.6):HSET(216.148 

.6) 

970 HPRINT(1.3)."F0UR LITTLE." 

980 PLAY"FL8FF" 

990 HSET(216.156.6):HSET(220.156 

.6) 

1000 HPRINT(14.3)."THREE LITTLE. 

1010 PLAY"L4FL8FF" 

1020 HSET(206.158.6):HSET(210.15 

8.6) 'OUT 2 EYES 

1030 HPRINT(28.3)."TW0 LITTLE" 

1040 PLAY"L4A03L8CC02L4AF" 

1050 HPAINT(0.24).0.2 

1060 HPAINT(32.40).0.2 

1070 HPRINT(1.3)."0NE LITTLE IND 

IAN BOY." 

1080 PLAY"03L4C02L8B-B-L4AGL2.F" 

1090 HDRAW"BM26.163:C2;R2U1R1U1R 

1E1H1L1G2L2U1L1U1L2D1R1D1R1D1R1D 

1R1F1R2E1U2" 

1100 HPAINTC27.162) .3.2 

1110 HPAINTC28. 164) .1.2 

1120 GOTO1120 

1130 PHODE3.1:PCLS:SCREEN1.0:CLS 

3 

1140 FOR X-l TO 4 

1150 PRINT0294." TEN LITTLE INDI 

ANS ": 

1160 FOR D-l TO 1000:NEXT D 

1170 FOR B-130 TO 157 STEP 3:PRI 

NT@B.CHR$(191)::NEXT 

1180 FOR B-295 TO 312: PRINT@B.CH 

R$(191)::NEXT 

1190 FOR B=296 TO 308: PRINTOB.CH 

R$(239)+CHR$(255)+CHR$(159)+CHR$ 

(191)::NEXT 

1200 FOR B-308 TO 295 STEP-1 :PRI 

NT@B.CHR$(223)+CHR$(159)+CHR$(25 

5)+CHR$C191)::NEXT 

1210 SOUND RND(25).RND(3) 

1220 NEXT X 

1230 FOR 8=294 TO 300: PRINT@B." 

TEN LITTLE INDIANS ": 

1240 SCREEN0.1 

1250 FOR D-l TO 1500:NEXT D 

1260 RETURN 
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Breakpoint 



Creating a C Library 



by Greg Law 

Technical Editor 

Once you've written, de- 
bugged and compiled a set 
of functions you use often, 
you can store these func- 
tions in a library file in the 
/dd/ LIB directory. As outlined in previous 
columns, some of the functions you may 
want to add to a library include the new 
OS-9 Level II system calls, text and graphics 
display functions and any other functions 
you plan to use more than once. A single 
relocatable object module typically has an 
extension of .r (such as fopen.r or 
fwri te . r). and a set of relocatable object 
modules merged into a library typically has 
an extension of .1 (such as clib.l or 
cgfx.l). And since a library is nothing 
more than several relocatable object mod- 
ules merged into one file, you may think 
you can simply merge all of your relocat- 



struct 
1 

long 




H Sync: 


unsigned 


H TyLang; 


char 


H Valid: 


char 


H 0ate[5]: 


char 


H Edition: 


char 


H Spare: 


unsigned 


H Global: 


unsigned 


H DGlobal : 


unsigned 


H Data: 


unsigned 


H.DData: 


unsigned 


H OCode; 


unsigned 


H Stack: 


unsigned 


H Entry: 


) ROF Header: 




Figure 1: Relocatable Object- 


Module Header 



//( addition to being 9S-9 Online SICop, 
Greg Law enjoys programming on all types 
of computers and has worked on systems 
ranging from the CoCo to the Burroughs 
Bh7iHi super mainframe. He lives in Louis- 
ville. Kentucky. 



able object modules into a library file. If 
only it were that simple. 

Before discussing why creating a library 
isn't that simple, let's examine the format 
of a relocatable object module to better 
understand the traps involved. Each relo- 
catable object module contains, in order, 
the module header, module name, global 
symbol table, object code, initialized direct 
page data, initialized data, external symbol 
table, local symbol table and. optionally, a 
common block table. 



struct 
I 

unsigned Count: 

struct 

I 

char *Name; 

char Type: 

unsigned Offset; 

I Refs[Count]: 
) Global s: 

Figure 2: (ilobal Symbol Table 



The formal of the 24-byte module header 
is shown in Figure I . The first four bytes are 
always S62CD2387 and are used for synchro- 
nization. The general idea is that if a library 
file becomes corrupted, it may be possible 
to recover most of the relocatable object 
modules by searching for the synchroniza- 
tion values. These synchronization values 
are also used to confirm that data within a 
file is actually a relocatable object module. 

The next two bytes are the module's 
type, language, attributes and revision. The 
following byte is used to check the validity 
of the relocatable object module. A value of 
zero indicates the source code is assembled 
without any errors. If errors are detected by 
the assembler, a value of nonzero is stored 
in this byte. The next five bytes are the date 
and time the relocatable object module was 
created. The byte after that reflects the 



edition. This is followed by one byte that is 
reserved for future use. 

The remaining data in the module header 
indicate the size of the unitialized data, 
unitialized direct page data, initialized data, 
initialized direct page data, object code, 
stack and, finally, the entry point in the 
module. Normally the type/language and 
entry point for a module is snooo, which 
means the module is a subroutine that is 
called by other modules. Only the relocat- 
able object module that contains the entry 
point of the program defines the entry point 
and the type/language bytes. Immediately 
following the module header is a null-ter- 
minated string that defines the name of the 
relocatable object module. 



struct 
I 

unsigned Countl; 

struct 

I 

char *Name: 
unsigned Count2; 

struct I 

char Type: 

unsigned Offset: 
I Refs[Count2]; 
I Symbol s[Countl]: 
) Externals: 

Figure 3: External Symbol Table 



The first two bytes in the global symbol 
table indicate the number of global symbols 
contained in the table and is followed by 
this number of entries. Each entry in this 
table contains a null-terminated string de- 
fining the name of the symbol followed by 
a one-byte type and a two-byte offset. The 
symbol type defines whether the symbol is 
a variable (located in the data section) or a 
subroutine (located in the code section). 
The structure for the global symbol table is 
loosely defined in Figure 2. However, keep 
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in mind thai the structure shown is illegal C 
syntax due to the way in which ihe array is 
dimensioned. 



library is 
nothing more 
than several 
relocatable 
object 
modules 
merged into 
one file. 



The next items up for bid are ihe object 
code, initialized direct page data and initial- 
ized data. The number of bytes in each of 
these sections is defined by H OCode. 
H_DData and H Data, respectively. The 
initialized direct page and initialized data 
sections contain the actual values that are 
copied into the data area at run lime by 
either the cstart or root modules. 



struct 

I 

unsigned Count; 

struct 

( 

char Type: 

unsigned Offset: 

} RefsCCount]; 
) Locals; 

Figure 4: Local Symbol Table 



The first two bytes in the external sym- 
bol table define the number of entries in the 
table and is followed by this number of 
entries. Each entry in this table contains a 
null-terminated string that defines the name 
of the external symbol and a two-byte value 
indicating the number of references to this 
symbol. A subtable follows this with one 
entry per reference that contains a one-byte 
reference type and a two-byte offset. The 
structure of the external symbol table is 
loosely defined in Figure 3. As with the 
global symbol table, the exact structure of 
the external symbol table cannot be legally 
represented so take these figures with a 
grain of salt. 

The structure of the local symbol table 
(shown in Figure 4) is close to that of the 
external symbol table except there is no 
symbol name or a secondary count value. 



The common block (shown in Figure 5) 
is perhaps the most difficult structure to 
handle. The most difficult aspect of the 
common block is that older versions of RMA 
(including c.asm bundled with the C com- 
piler) do not generate the common block 
table. However, the version of RMA bundled 
with the OS-9 Development System always 
generates a common block table. By the 
same token, older versions of RLink 
(including clink bundled with the C 
compiler) stop dead in their tracks and exit 
with an error if they encounter a common 
block table. Fortunately, the version of RLink 
bundled with the OS-9 Development System 
can handle relocatable object modules ei- 
ther with or without a common block table. 

So, what's the difference between a 
global, an external and a local symbol? A 
global symbol is a symbol (either a func- 
tion, subroutine or variable) that is defined 
within this relocatable object module. For 
example, if you compile a C source file that 
contains a qsortO function, qsort be- 
comes a global symbol in the global symbol 
table. An external symbol is a symbol (ei- 
ther a function, subroutine or variable) that 
is referenced within this module, but is 
defined in another module. The local sym- 
bol table typically contains all of the static 
data defined within a C source file. Re- 
member, a variable that is declared as static 
cannot be referenced by any module other 
than the one in which it is declared. The 
common block is used only by the 
Microware FORTRAN compiler, and for all 
intents and purposes is always blank — 
unless the module is generated by FOR- 
TRAN. 

The Linker 

Both the global and external symbol 
tables are extremely important to the linker. 
When several relocatable object modules 
are linked to form an executable program, 
the linker creates a table in memory of all 
external symbols found in each of the 
modules. The linker then searches the global 
symbol tables for each of the external 
symbols. When it finds a relocatable object 
module that contains a global symbol match- 
ing one of the external symbols, that mod- 
ule is merged onto the end of the executable 
program. So far. so good. Unfortunately, 
the linker does not search a library file more 
than once to resolve all external symbols, 
and it is possible to create a deadlock. Let's 
assume for a moment that we create three 
modules called exit.r. errmsg.r and 
abort. r. Let's also assume aborU ) calls 
errmsg( ) and errmsg( ) calls exi t( ). It is 
very important to remember that the linker 
searches the library file once and only once. 
For that reason, each external symbol must 
reference a global symbol that is located 



after this module. With that in mind, the 
three modules in our example should be in 
this order: abort, r, errmsg . r and exi t . r. 
Use the key phrase "a calls b" to find the 
correct ordering of the modules. For 
example, abortO calls errmsg( ). so 
abort . r (the module containing abort( )) 
should be in the lite before errmsg . r (the 



struct 
{ 

unsigned Countl; 

struct 

I 

char *Name; 
unsigned Size: 
unsigned Count2: 

struct 
1 

char Type: 

unsigned Offset: 
) Refs[Count2]; 
I Blocks[Countl]: 
I Common Block; 

Figure 5: Common Block Table 



module containing errmsgt ) ). 

Now, let's twist this scenario with a 
different set of modules. Again, assume we 
have three modules called a . r. b . r and c . r. 
Also assume that a( ) calls b( ). b( ) calls 
c( ) and c( ) calls a ( ). This combination is 
referred to as a deadlock because modules 
a and c cannot be inserted into a library file 
in such a way as to satisfy both modules' 
requirements. However, you should realize 
that deadlocks are rare and often can be 
easily prevented. In this example, the easi- 
est solution is to include both functions a ( ) 
and c( ) in a single source file. 

Another point to remember is that all 
functions contained within one C source 
file are compiled and assembled into a 
single relocatable object module. For ex- 
ample, assume you create a C source file 
called graphics, c that contains all of the 
text and graphics functions defined in the 
OS-y Level II manual. When the C source 
file is compiled and assembled, a file called 
graphics, r is created. Now for the bad 
news: If you compile a program that calls 
any of the functions located in graphi cs . r. 
all of the functions within that module are 
linked into your program. For that reason. I 
don't recommend including large library 
routines in a single file. On Ihe other hand, 
ii is perfectly reasonable to include set and 
end pairs (DWSet and DWEnd. OWSet and 
OWEnd. etc.) in a single file. It is fairly safe 
to assume that most programs that call 
DWSet will also call DWEnd. The point to 
remember is that you really don't want all 
of your programs picking up a bunch of 
excess baggage. ^\ 
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The Assembly Line 




by William P. Nee 



Consider a stone dropped into a 
pond, a beating heart or someone 
stirring his coffee. What do all 
these actions have in common? 
They produce 
waves that move in 
directions away 
from the distur- 
bance and interact 
with whatever they 
touch. These waves 
might be electrical 
impulses along 
heart muscles, rust 
spreading on metal, 
or ripples on a pond. 
Using a principal 
developed by John 
Tyson of v.pj.. we'll 



simulate these waves of motion in a me- 
dium. 

Whatever medium we use. we will con- 
sider it to be in an excited state, called U. or 



U=0(Line 130): 

if V >= V then V NEW = V-GD: if V N|£W < 0. then V NEW = 0: end 



— if E > K FXC . then U NFW = 1 : end 

— if E <= R FXC . then V NEW = V-GD: if V NEW < 0. then V NKW = 0: end 

U=1 (Line 200): 

- ^ V <= V uax- then V NBW = V+G ^ it" V NKW > V MAX . then V NFW = V^: end 
_ if V = V MAX . then U NFW = 0: end 

— if EE > K K| ' ( .. then IL™ = 0: end 

- if EE <= K R|£C . then V^ = V + GU: if V SEW > V MAX . then V NEW = V MAX : end 

Figure 1: Rules for Listing 1 



Bill Nee backed the snowbird trend by retir- 
ing to Wisconsin/mm a bunking career in 
Florida. The success of his 1 3 -part series, 
"Machine Language Made BASIC" (July 
I9SH to July 19X9), prompted him to continue 
writing articles about Color Computer 
machine-language programming. You may 
contact Bill at Route 2. Box 2I6C. Mason. Wl 
54H56-9J02, (715) 746-2952. Please include an 
SASH when requesting a reply. 



a recovery state. V. The variable used to 
reflect the U state can be one of two values: 
Zero indicates unexcited. and One means 
excited. The recovery-state variable may 
range between zero and V MAX . which we 
will assume to be 100. When U is one, V 
may increase until il reaches V MAX at which 
time U becomes zero. When U is zero. V de- 
creases until it reaches zero. At this point 
(U=o, v=o). the medium is stable. As it 
changes. V increases by an amount we'll 



call G Lp and decreases by G 



down- 



U, V. G lip and G^^ are not the 
only factors involved — if they were, the 
medium would quickly settle down to a 
stable state and all wave action would stop. 
While our CoCo 
can't handle the nu- 
merous variables 
that affect wave 
motion, we can use 
a few to demonstrate 
a realistic simple 
wave. We'll use 
V |iXC to represent a 
sufficiently recov- 
ered V state value 
and V R1C to repre- 
sent a sufficiently 
unexcited V state 
value. 

As with any 
game of Life, the status of all points around 
a given point affect that point's new status. 
We need to check all of a point's neighbors 
to a distance of R. This includes all the 
points within a 2R+I square centered on the 
desired point. We'll generally use a value 
of 3 for R. so we'll be looking at 49 points to 
determine each new value. The sum of all 
the excited cells (U=l ) in a neighborhood is 
E, and the number of unexcited cells (EE) is 
given by 49-E. 

The last two factors, K FXf and K RFC . 
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represent the smallest values thai allow the 
wave to keep moving. These values are 
usually less than R(2R+n. A cell whose U 
value is zero can become excited if the cur- 
rent V value is less than V EX( . and the 
number of excited cells in a neighborhood 
(E) is greater than K EXC . Conversely, an 
excited cell can become unexcited (U=()) if 
V equals V MAX . or if the number of unex- 



V value gets closer to zero, fewer and fewer 
neighbors are needed to change the cell's U 
value to one. Conversely, as an excited 
cell's V value gets closer to V mx , more and 
more neighbors are needed to change its U 
value to zero. We'll reflect this by spread- 
ing the K values out in an array from zero to 
V MAX , based on the formulas 



cited cells in its neighborhood (EE) is greater K ExnVl = K,. :) . C +(R(2R+1 )-K EXC )*( V/V EXC ) 



than K K[;r and V is between V REC and V MAX 



The Software 

Listing I shows a basic program that 
demonstrates the effects of these factors. 
The area we'll look at is a 2()-by-20 grid. 
Line 30 reads the variables; VM. which is 
V is understood to be too. Line 40 
computes the size of the neighborhood. The 
demonstration fills the left half of the dis- 
play area with an excitable (U=l) medium. 
The right half is still unexcited (u=o). and 
all V values are zero. 

Starting with Line 90 are a series of loops 
that check all the cells within a square of R 
to 20-R for the current U and V values. A 
summary of the rules used is shown in 
Figure 1. Notice that there is only one way 
an unexcited state U can go from zero to 
one. but there are two ways an excited state 
can go from one to zero. This gradually 
dampens the initial disturbance, smoothing 
things just as in real life. 

The last part of the BASIC program (Line 
300) transfers the new U and V values back 
to the original arrays and. to demonstrate 
the results, plots the U values for all points. 
The subroutine at Line 350 computes the 
number of excited cells (U=t) within the 
neighborhood (E). 

Run this program for a while and you 
can begin to see the wave spread out. Ini- 
tially it may take a minute to compute just 
one new generation. Even though the E 
values are computed only when necessary, 
each of these computations takes 49 steps. 
It's going to take a machine-language pro- 
gram to demonstrate the simulation with 
any real speed. 

A basic Driver 

Before looking at the machine-langauge 
program, we need to make one refinement 
to the K values used. As an unexcited cell's 



(V -V ) 

' MAX REC' 



v-V) 



Now the E value is compared to K EXC(V) , 
and EE is compared to K REC(V) . The BASIC 
driver (Listing 2) for the machine-language 
program incorporates these computations. 
One other change needs to be consid- 
ered: Computing those 49 values takes long 
enough when R is 3. Imagine how long it 
would take if we used a value of 5 or 6 for 
R. That would be 169 cells to evaluate! 
There is another procedure we can use. but 
it requires an additional array we'll call 
SUMS. Any point in this array, say S( I.J), 
equals the corresponding U value. U( I . J ). 
When this array is filled, it takes only four 
values to compute E for each point (I.J). 
These four values are at the corners of a 
rectangle around the point at a distance of 
R.SoE(I.J)equalsSU+R.J+R) + SCI-R- 
l.J-R-1) - SU-R-l.J+R) - S(I+R.J-R- 
1 ). Now the number of steps necessary to 
compute E will not be dependent on the size 
of R. Of course the SUMS array must be 
modified at the beginning of each new 
generation. The basic driver computes the 
distance of those four comers, based on R. 
from the center cell in lines 160 through 190 
and pokes them into their proper locations 
(lines 200 through 230). 

Bits and Bytes 

The machine-language program. WAVES. 
is shown in Listing 3. It uses a 1 04-by-96 grid 
and V MAX equals loo. You define the other 
variables and set up the initial demonstra- 
tion (half-full, one circle, two circles, etc) 
via options given in the BASIC driver. WAVES 
uses a PM0DE screen with reverse colors 
(black on white). 

Three macros are defined initally: ZERO. 
PPOINT and LOCATE. ZERO clears the area 



from $3600 to $F9(H> where the arrays are 
stored. Since the area above S7FFF is being 
used, the interrupts must be enabled and 
SFFDF cleared. 

PPOINT reads the entire display area to 
see what demo situation you have set up. If 
any point has been set (a zero, in reverse 
color) the corresponding locations in the 
OLOU and NEWU arrays are set to one. 

Based on the across and down values. 
LOCATE computes the current location within 
an array. Even though some of these mac- 
ros are used only once, they make writing 
the program a lot quicker and also make the 
program easier to follow. 

The CLEAR routine (Line 730) enables the 
interrupts, sets high RAM. and calls the ZERO 
macro. DEMO in Line 800 sets the DP register 
to $30 since the high byte of all variable 
locations is S30. This shortens the program 
as well as speeds it up. The PPOINT macro 
then transfers your data for the situation 
you choose to Array OLDU. 

Actual computations begin at START 
(Line 870) with Location OLDU(l.l). The 
LOCATE macro computes the actual location 
within the array, and the current U value 
and three SUMS values are combined for the 
current SUMS value. NEXT begins at 
0LDU(R+1 .R+l) and transfers the current U 
and V values to the arrays NEWU and NEWV. 
Then the Rules check begins. 

If U equals one. the program branches to 
TEST1. If not, the current V value is com- 
pared to VEXC. If the V value is greater than 
or equal to VEXC, the program branches to 
TESTOA at Line 1630. If not, the number of 
excited cells (E) in the neighborhood is 
computed and compared to the correspond- 
ing V value in Array KEXC. If E is greater, 
the value in NEWU is set to one. If not, the 
program branches to Line 1630. Routine 
TESTOA subtracts GDOWN from the current V 
value and stores the result or zero, which- 
ever is greater, in NEWV. 

TEST1 (Line 1690) compares the currenl 
V value to VREC. If it's equal to or less than 
VREC, the program branches to TEST1A. If 
the V value equals VMAX, NEWU is set to zero. 
If not. the E value is computed and sub- 
tracted from RR to get EE. This is then 
compared to the corresponding V value in 
Array KREC. If it's lower, the program 
branches to TEST1A. Otherwise NEWU is set 
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to zero. TEST1A adds GUP lo the current 
value of V and stores the result or VMAX. 
whichever is less, in NEWV. 

These computations are carried out until 
ACROSS reaches LENGTH - R and DOWN 
reaches WIDTH - R. QSHOW (Line 2160) 
transfers the NEWU and NEWV values to OLDU 
and OLDV. and displays the result. Rather 
than PSET each point on the screen, the U 
data is transferred eight bits at a time to 
TOTAL, which is then poked into the proper 
graphics locations. Notice in Line 2260 that 
TOTAL is shifted left before storing the U 
value. This keeps Bit 7 from being bumped 
out after the eighth shift. The COMA in Line 
2360 reverses the value of each bit before 
poking it into graphics memory since we*re 
using reverse colors. Because the program 
branches immediately back to START, the 
only way to stop execution is by pressing 
the Reset button. Once you've entered and 
debugged the program, save the source 
code with w WAVES. ASH and assemble it 
with A WAVES.BIN /NS/WE. 

The BASIC driver for this program (List- 
ing 2) sets the screen to PMODE 0. 1. clears 
space for and loads, if necessary, the ma- 
chine-language program. All the required 
data, including the KREC and KEXC arrays are 
poked into their locations. Line 240 exe- 
cutes the Z E R0 macro, clearing space for the 
U and V values. Lines 270 through 310 are 
different demos you can try. or you can add 
yourown. Remember that the graphics start 
three bytes to the right, and all x and v 
coordinates must be doubled for PMODE 0. 
The DATA statements in lines 330 through 390 
are various values for the variables used. If 
you try yourown data, follow these guide- 
lines: 



0<G L . p < 100 



0< G D OWN< 100 



0< V EXC< V K E C<'"« 



0<5=K EXC <=R(2R+I) 



< K REC . <= RI2R+I) 



You may have to adjust K RK . to keep 
all values of K Rr . C|V) greater than zero and 
less than 255 since there is only one byte of 




data reserved for each of them. After you've 
entered the BASIC driver, save it as 
WAVES2.BAS. 

Some changes you might like to try 
include: 

1 ) coloring the V values instead of U 

2) increasing the size of the display. 
You'll probably have to combine the U and 



V values into one array by making U=0 a 
positive number and u= I a negative number 
(Bit 7 cleared or set). 

Whatever changes you make. I hope you 
enjoy creating waves. In the next article 
we'll investigate some of the rules of Life. 
If you have any suggestions for future ar- 
ticles, please don't hesitate to write. -J 





64K Disk ^ 




Listing 1: WAVES1 






10 L-20:VM=100 


210 


IF V<-VR THEN 260 


20 DIM U(L.L).UU(L,L),V(L,L).VV( 


220 


IF V-VM THEN UU(X ,Y )-0:GOTO 


L.L) 


290 


30 READ R.VR.VE.GU.GD.KR.KE 


230 


GOSUB 350 


40 RR-(2*R+1)*(2*R+1) 


240 


EE-RR-E 


50 PMODE0.1:PCLS:SCREEN1.1 


250 


IF EE>KR THEN UU(X .Y)=0:GOTO 


60 FOR Y-0 TO L:F0R X-0 TO L/2 


290 


70 U(X,Y)-1:UU(X.Y)-1 


260 


'TEST 1A 


80 PSET(X+X.Y+Y):NEXT X.Y 


270 


V=V+GU:IF V>VM THEN V-VM 


90 FOR X-R TO L-R:F0R Y-R TO L-R 


280 


VV(X.Y)-V 


100 U-U(X.Y):UU(X.Y)-U 


290 


NEXT Y.X 


110 V-V(X.Y):VV(X.Y)-V 


300 


FOR X-0 TO L:F0R Y-0 TO L 


120 IF U-l THEN 200 


310 


U-UU(X.Y):U(X.Y)-U 


130 'TEST 


320 


V=VV(X.Y):V(X.Y)-V 


140 IF V=>VE THEN 180 


330 


PSET(X+X.Y+Y.U) 


150 GOSUB 350 


340 


NEXT Y.X:G0T0 90 


160 IF E>KE THEN UIKX ,Y)-1 :G0T0 


350 


E-0 


290 


360 


FOR I-X-R TO X+R 


170 'TEST 0A 


370 


FOR J-Y-R TO Y+R 


180 V-V-GD:IF V<0 THEN V-0 


380 


IF UU.JM THEN E-E+l 


190 VV(X.Y)-V:G0T0 290 


390 


NEXT J.I:RETURN 


200 'TEST 1 


400 


DATA 3.95.80.24.19.9.5 



Your CoCo 4 is here! 

i The TOMCAT! 

L I ^^M f The only computer 



that will use your 
existing hardware 
AND software! 
And what a price! 



Jetttca^ 



Frank Hogg Laboratory Inc. 

204 Windmere Road Syracuse New York 13205 
To Call.. .315/469-7364 To Fax...3 15/469-8537 

ORDERING INFORMATION: VISA and M/C, check and C.O.D. Continental U.S. software 
shipping add $5.00 Ground.- $8.00 Two Day Air. Hardware add $1 5. Ground- $27 Two Day Air. 
Please call tor Next Day Air costs and C.O.D. Foreign add 10% Shipping (Minimum $5 USD) 
NY residents please add 7% sales tax. 




October 1991 THE RAINBOW 



45 



Listing 2: WAVES2 






10 PMODE0.1:PCLEAR1:CLS 


150 POKE K1+V.INT(K):NEXT 


260 PMODE0.1:COLOR0.5:PCLS:SCREE 


20 CLEAR 200.&H3000-1 


160 E1-R*(SZ+1) 


Nl.l 


30 IF PEEK(&H30DD)<>26 THEN LOAD 


170 E2— (R+1)*(SZ+1):E2-&HFFFF+E 


270 LINE(32.0)-(136.190).PSET.BF 


M"WAVES":POKE&HFF40.0 


2+1 


280 'LINE(32.0)-(240.190).PSET.B 


40 PRINTS203, "COMPUTING" 


180 E3-R*(SZ-1)-1 


F 


50 K0-&H3013:K1-&H3078 


190 E4-R-SZ*(R+1):E4-&HFFFF+E4+1 


290 -L1NE132. 0)^128. 64). PSET.BF 


60 READ R.VR.VE.GU.GD.KR.KE 


200 HI-INTCE1/256) : LO-E1 - 256*HI : 


:LINE(32.128)-(128.190).PSET.BF 


70 VM-100 


POKE &H31AA.HI:P0KE &H31AB.LO:PO 


300 , CIRCLE(38.96).4*R:PAINT(38. 


80 SZ-104 


KE &H31FE.HI :POKE &H31FF.L0 


96). 0.0 


90 POKE&H3000.VM:POKE&H3001.VR:P 


210 HI=INT(E2/256):LO-E2-256*HI: 


310 , CIRCLE(38.64).4*R:PAINT(38. 


OKE&H3002.VE 


POKE &H31B0.HI:POKE &H31B1.L0:P0 


64).0.0:CIRCLE(38.128).4*R:PAINT 


100 POKE&H3003.GU:POKE&H3004.GD 


KE &H3204.HI:POKE &H3205.LO 


(38. 128). 0.0 


110 POKE&H3005.SZ:POKE&H3006.R:R 


220 HI-INT(E3/256):L0-E3-256*HI: 


320 EXEC &H30F3 


R-(2*R+1)*(2*R+1):R1-R*(2*R+1):P 


POKE &H31B8.HI:P0KE &H31B9.L0:P0 


330 DATA 3.85.80.24.19.7.5 


OKE&H3007.RR 


KE &H320C.HI:POKE &H320D.LO 


340 'DATA 2.85.80.24.19.7.5 


120 POKE &H3011.103-R:POKE &H301 


230 HI-INT(E4/256):L0-E4-256*HI: 


350 "DATA 3.70.65.20.5.5.0 


2.95-R 


POKE &H31C1 .HI :POKE &H31C2.LO:PO 


360 'DATA 3.90.85.25.20.7.5 


130 FOR V-0 TO VM:K-KE+(R1-KE)*( 


KE &H3215.HI:POKE &H3216.LO 


370 'DATA 3.90.85.20.5.5.0 


V/VE):POKE K0+V.INT(K) 


240 EXEC &H30DD 


380 'DATA 6.82.71.12.5.53.0 


140 K-KR+(R1-KR)*(VM-V)/(VM-VR) 


250 'YOUR DEMO 


390 'DATA 3.82.71.12.5.25.0 



Listing 3: waves. asm 



00100 
00110 

00120 

00130 

00140 

00150 

00160 

00170 

001B0 

00190 

00200 

00210 

00220 

00230 

00240 

00250 

00260 

00270 

00280 

00290 

00300 

00310 

00320 

00330 

00340 

00350 

00360 

00370 

00380 

00390 

00400 

00410 

00420 

00430 

00440 

00450 

00460 

00470 

00480 

00490 

00500 

00510 

00520 

00530 

00540 

00550 

00560 

00570 

00580 



* RECOV 
PPOINT 



\.D 

\.C 
\.B 



ERY 104X96 
MACRO 
LDU 
LDX 
LEAX 
LDB 



\.A 



ZERO 
\.A 



LOCATE 



VMAX 

VREC 

VEXC 

GUP 

GDOWN 

SIZE 

R 

RR 



STB 

LDA 

STA 

LDA 

LDB 

LSLA 

BCS 

INC 

INC 

LEAU 

OECB 

BNE 

DEC 

BNE 

LEAX 

DEC 

BNE 

ENDM 

MACRO 

LDU 

CLR 

CMPU 

BNE 

ENDM 

MACRO 
LDA 
LDB 
MUL 
ADDB 
AOCA 
ENDM 

ORG 
RMB 
RMB 
RMB 
RMB 
RMB 
RMB 
RMB 
RMB 



#OLDU 

$BA 

2.X 

#96 

DOWN 

#13 

ACROSS 

.X+ 

#8 

\.A 
.U 



DISPLAY IS 3 BYTES OVER 



REVERSED COLORS (0-PSET) 
OLDU-1 



S2700.U NEWU-1 
l.U 



\.B 

ACROSS 

\.C 

3.X 

DOWN 

\.D 



#$3600 
.U+ 

#$F900 
\.A 



\1 
\2 

\0 

#0 



$3000 

1 

1 

1 

1 

1 

1 

1 

1 



NEXT ROW. 3 BYTES OVER 



START OF OLDU 



END OF SUMS 



00590 E 


RMB 


1 


00600 EE 


RMB 


1 


00610 UU 


RMB 


1 


00620 VV 


RM8 


1 


00630 TOTAL 


RMB 


1 


00640 ACROSS 


RM8 


1 


00650 DOWN 


RMB 


1 


00660 XI 


RMB 


1 


00670 Yl 


RMB 


1 


00680 XR 


RMB 


1 



00690 YR 


RMB 


1 






00700 K0 


RMB 


101 


KEXC ARRAY (0 - 


100) 


00710 Kl 


RMB 


101 


KREC ARRAY (0 - 


100) 


00720 










00730 CLEAR 


ORCC 


#$50 


ENABLE INTERRUPTS 


00740 


CLR 


$FFOF 


HIGH RAM 




00750 


ZERO 








00760 


CLR 


JFFDE 


LOW RAM 




00770 


ANOCC 


#$AF 






00780 


RTS 








00790 










00800 DEMO 


ORCC 


#$50 






00810 


CLR 


$FFOF 






00820 


SETDP 


$30 


VARIABLES BEGIN 


WITH 


00830 


LDA 


#$30 






00840 


TFR 


A. DP 






00850 


PPOINT 








00860 










00870 START 


LDU 


#OLDU 






00880 


LDA 


#1 






00890 LI 


STA 


DOWN 






00900 


LDB 


#1 






00910 L2 


STB 


ACROSS 


START AT U(l.l) 




00920 


LDY 


ffSUMS 






00930 


LOCATE 


ACROSS. 


DOWN. SIZE 




00940 


LEAY 


D.Y 






00950 


LDA 


D.U 






00960 


STA 


TOTAL 






00970 


LDA 


-l.Y 


S(I-l.J) 




00980 


ADDA 


TOTAL 






00990 


STA 


TOTAL 






01000 


LDA 


-104.Y 


S(I.J-l) 




01010 


ADDA 


TOTAL 






01020 


STA 


TOTAL 






01030 


LOA 


105. Y 


S(I-l.J-l) 




01040 


NEGA 








01050 


ADDA 


TOTAL 






01060 


STA 


,Y 






01070 


LDB 


ACROSS 






01080 


1NCB 








01090 


CMPB 


#103 






01100 


BLS 


L2 






01110 


LDA 


OOWN 






01120 


INCA 








01130 


CMPA 


#95 






01140 


BLS 


LI 






01150 










01160 NEXT 


LDA 


R 






01170 


INCA 








01180 L3 


STA 


DOWN 






01190 


LDB 


R 






01200 


INCB 




START AT U(R+1 


R+l) 


01210 L4 


STB 


ACROSS 






01220 


LOCATE 


ACROSS 


DOWN. SIZE 




01230 


LDU 


#OLDU 






01240 


LDX 


#OLDV 






01250 


LDY 


#SUMS 






01260 


LEAU 


D.U 






01270 


LEAX 


D.X 






01280 


LEAY 


D.Y 







46 



THE RAINBOW October 1991 



01290 


IDA 


,U 


GET CURRENT U VALUE 


02210 STA DOWN 


01300 


STA 


UU 


SAVE IT 


02220 Q3 LDB #13 II BYTES ACROSS (104/8) 


01310 


STA 


$2700. U 




02230 STB ACROSS 


01320 


LDB 


.X 


GET CURRENT V VALUE 


02240 02 CLR TOTAL 


01330 


STB 


VV 


SAVE IT 


02250 LDB //8 // BITS PER BYTE 


01340 


STB 


$2700. X 




02260 Ql LSL TOTAL 


01350 


TST 


UU 


U-0 ? 


02270 CLR ,Y+ CLEAR SUMS 


01360 


LBNE 


TESTl 




02280 LDA $7500. U NEW V 


01370 








02290 STA $4E00.U OLD V 


01380 TEST0 


LDA 


VV 


1 


02300 LDA $2700. U NEWU 


01390 


CMPA 


VEXC 


V->VEXC ? 


02310 STA .U+ OLDU 


01400 


BHS 


TEST0A 




02320 ADDA TOTAL 


01410 


LDA 


315. Y 


SU+R.J+R) 


02330 STA TOTAL SAVE U VALUES 


01420 


STA 


TOTAL 




02340 0EC8 


01430 


LDA 


-420. Y 


S(I-R-l.J-R-l) 


02350 BNE 01 


01440 


ADDA 


TOTAL 




02360 COMA REVERSE THEM 


01450 


STA 


TOTAL 




02370 STA ,X+ AND DISPLAY THEM 


01460 


LDA 


308. Y 


Sd-R-l.J+R) 


02380 OEC ACROSS 


01470 


NEGA 






02390 BNE 02 


01480 


ADDA 


TOTAL 




02400 LEAX 3.X 


01490 


STA 


TOTAL 




02410 DEC DOWN 


01500 


LDA 


-413. Y 


SU+R.J-R-1) 


02420 BNE 03 


01510 


NEGA 






02430 LBRA START 


01520 


ADDA 


TOTAL 




02440 


01530 


STA 


E 




02450 OLDU EOU $3600 


01540 


LOA 


VV 




02460 NEWU EOU $5000 


01550 


LOB 


E 




02470 OLDV EOU $8400 


01560 


LOY 


//K0 




02480 NEWV EOU $AB00 


01570 


CMPB 


A.Y 


E>KEXC(V) ? 


02490 SUMS EQU $0300 


01580 


BLS 


TEST0A 




02500 FINIS * 


01590 


LDA 


#1 




02510 END DEMO _ 


01600 


STA 


$2700. U 


NEWU-1 


/W\ 


01610 

01620 

01630 TEST0A 

01640 

01650 

01660 TST0A1 


LBRA 

SUBA 
BPL 
CLRA 
STA 


DONE 

GDOWN 
TST0A1 

$2700. X 


NEWV-V-GDOWN 










3 B SO^QiT 1L0© B ; ■ 

■ ■■■■ ■ ■■■ 


01670 
01680 


LBRA 


DONE 






Soviet Bloc: Form solid rows from falling block shapes 


01690 TESTl 
01700 
01710 
01720 


LDA 
CMPA 
LBLS 
CMPA 


VV 


u • unrc *} 




in this super Tetris-style game. CoCo3. $1 9.95 


VREC 

TEST1A 

VMAX 


V<-VREL : 
V-VMAX ? 




®i©ira®iM ip&™ gjsg] 


01730 
01740 
01750 


BNE 
CLR 
LBRA 


TEST11 
$2700. U 
DONE 






Sliding tiles challenge you in this ever- "rkli^X-i 
changing maze. Fun for all ages. 1-4 players. ■"•"" 


01760 

01770 TEST11 

01780 

01790 


LDA 
STA 
LDA 


315. Y 

TOTAL 
-420. Y 






CoCo3. Joystick. $19.95 


SOLITAIRE CARD GAMES 


01800 
01810 


ADDA 
STA 


TOTAL 
TOTAL 






Classic Solitaire: Three 


La Belle Lucie: Very 


01820 


LDA 


308. Y 






games in one. Klondike, 


addicting. This solitaire 


01830 
01840 


NEGA 
ADDA 


TOTAL 






Canfield and Pyramid on 


quickly becomes a 


01850 
01860 


STA 

LDA 


TOTAL 
-413. Y 






one disk for just $14.95 


favorite. $14.95 


01870 
01880 
01890 


NEGA 
ADDA 
STA 


TOTAL 
E 






Both play on 1 28K CoCo3, with joystick and disk. 






Solitaire Special: Both disks for just $25.00! 


01900 
01910 
01920 


LDB 

SUBB 

STB 


RR 

E 
EE 






ARCADE 


0S9/LII (51 2K) 


01930 


LDA 


VV 






Crystal City $34.95 


Tazman $24.95 


01940 
01950 
01960 
01970 


LDB 
LDY 
CMPB 
BLS 


EE 
Hi 
A.Y 
TEST1A 


EE>KREC(V) ? 




Zenix $29.95 


Kyum-Gai (To Be Ninja) $29.95 


Armchair Admiral (CoCo3 Disk) $14.95 


01980 
01990 


CLR 
BRA 


$2700. U 
DONE 






Riddle of the Ring (CoCo3/CoCo2 Disk) $10.00 


02000 

02010 TEST1A 


ADDA 


GUP 


NFWV-V+GIIP 




Games Pack (CoCo3/CoCo2 Disk) $10.00 


mj i» v J *J i i. ** i L *^ 

eze20 


CMPA 


VMAX 


II L n I V r iJU r 




COPY CAT 


02030 
02040 


BLS 
LDA 


TST1A1 
VMAX 






Simon Says in four colors, with sound. Can you repeat 


02050 TST1A1 
02060 


STA 


$2700. X 






the pattern? CoCo3. bisk. $10.00 or $5.00 with any 


02070 DONE 

02080 

02090 


LDB 

INCB 
CMPB 


ACROSS 
XR 


LENGTH-R 




other purchase. 


We will have new games at the Atlanta CoCoFest. 


02100 
02110 


LBLS 
LDA 


L4 
DOWN 






Stop by and say hello! 


02120 


INCA 








Software submissions invited 


02130 
02140 


CMPA . 
LBLS 


. VR 
L3 


WIOTH-R 




Checks, Money Orders, MasterCard & Visa $2.50 S&H 


02150 

02160 OSHOW 
02170 
02180 


LDU 
LDY 
LDX 


//OLDU 
//SUMS 
$BA 






COD $2.00 extra WA addr< 


jsses add 8.2% sales tax. 


' Eversoft Games, Ltd ' 


(206) 653-5263 


02190 
02200 


LEAX 
LDA 


2.X 
//96 


DISPLAY STARTS 3 BYTES OVER 
//ROWS DOWN (0 - 95) 




P.O. Box 3354 
.Arlington, WA 98223 


30 day money 
back guarantee 



L 
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An enhanced 
OS-9 display 
command 
that accepts 
decimals • • • , 



Easy 
Display 



by Stephen B. Goldberg 



A useful feature of OS-9 is the 
inclusion of commands that 
give users the ability to 
quickly change characteris- 
tics of the operating system. 
One example is the tmode command, which 
is used to change terminal baud, the number 
of lines on the screen, and much more. 
Another example is di splay. 

The di spl ay command is an OS- 1 ) utility 
that converts numbers, entered as parame- 
ters on the command line, to ASCII charac- 
ters and sends them to the appropriate out- 
put path. It is generally used to send control 
codes to the screen, which is the standard 
output path. For example, the accepted AS- 
CII code for a form feed i s 1 2 or SOC. To clear 
the screen, you would enter display c. 
With OS-9's output-path redirection, you 
could enter di spl ay c >/p to tell the printer 
to eject a blank page. (For more display 
codes, consult your OS-9 documentation 
and also "Kissable OS-9." October 1990, 
Page 58. ) 

Unfortunately, though, the display 
command is designed to accept numbers in 



Stephen Goldberg is a dentist and the au- 
thor of the Utilipak series <>fos-v utilities. 
He can he contacted at 695 Plainview Road. 
Bethpage, NY 1 1714. Please include an SASF. 
when requesting a reply. 



hexadecimal form only. If you entered the 
decimal number 12 with di spl ay. OS-9 would 
not clear the screen. This would not be a 
problem except that it makes more sense to 
enter the decimal values 80 and 24 to define 
an so-column window rather than using $50 
and six. I used to keep a pencil and some 
paper next to my CoCo for the purpose of 
manually converting decimal values to Hex 



for use with display. Others use fancy 
calculators that handle the conversion for 
them. We don't have to do this any more. 
Listing 1 is the assembly-language 
source code for a new display command 
that solves the problem. My version of 
display functions the same as the stock 
command when used with hexadecimal 
parameters — just enter them as you nor- 



OS-9 



* 



Listing 1: Display .asm 

* it***************************-********************* 
* 

* DISPLAY - (c) 1988 by S. B. GOLDBERG 

* 

* Display utility using decimal or hex format 
* 

* Use: display <[(]number[)]> [...] 



it 


if pi 
use 

endc 


/dd/defs/os9defs 


* 


mod 


1 en. name 


. prgrm+objct . reent+1 ,e 


char 

dcount 

dsiz 


rmb 
rmb 
rmb 
rmb 
equ 


1 

1 

200 

200 


character buffer 
digit count 
stack 
parameters 
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mally would. However, it also accepts 
numbers entered in decimal notation, which 
is faster for many people because it's more 
familiar: we work with decimal numbers 
every day. 

To tell my version of di spl ay you are 
using decimal numbers, enclose them in 
parentheses. The opening parenthesis. (. 



tells di spl ay the numbers following are in 
decimal form. The closing parenthesis, ), 
indicates thai decimal notation has ended 
and hexadecimal notation has resumed. Both 
Hex and decimal may be mixed on the 
command line. You need only make sure 
any group of one or more decimal parame- 
ters are enclosed in parentheses. 



name fcs /Display/ 

fcb 2 edition number 

fee /(c)1988 S.B.Goldberg/ 

****************************** 

* CONVERT HEX TO BINARY 

****************************** 



hextobin 


leax 
clrb 


-1.x 


reset parameter pointer 
zero value 






clr 


dcount 


zero digit count 






bsr 


hexcalc 


convert hex digit 




hexcalc 


Ida 


.X 


get character 






empa 


#'0 


valid hex digit? 






bio 


back 


no. end conversion 






empa 


#'9 


valid digit? 






bis 


makebin 


yes. convert to binary 






anda 


#$df 


alpha digit to upper case 






empa 


#-a 


val id hex digit? 






bio 


back 


no. end conversion 






empa 


tf'F 


valid digit? 






bhi 


back 


no. end conversion 






suba 


#7 


make alpha digit correct val 


ue 


makebin 


suba 


#•0 


convert digit to binary 






pshs 


a 


save current digit 






Ida 


#16 


multiply old 






mul 




total by 16 






addb 


.s+ 


add current digit 






1 eax 


1.x 


bump parameter pointer 






inc 


dcount 


count digit 




back 


rts 




return 





****************************** 

* PROCESS HEX PARAMETERS 

****************************** 



entry 


Ida 


,x+ 


parameter character 




empa 


#$20 


space? 




beq 


entry 


yes. look some more 




empa 


#'( 


decimal ? 




beq 


deel oop 


yes. do decimal parameters 




empa 


#') 


continue hex? 




beq 


entry 


yes. get next character 




bsr 


hextobin 


convert hex to binary 




tst 


dcount 


hex digits? 




beq 


noerr 


no. quit display 




stb 


iU 


yes. save character 




bsr 


print 


print character 




bra 


entry 


check for another parameter 


****************************** 


* CHARACTER TO 


STANDARD 


OUTPUT 


****************************** 


print 


pshs 


X 


save parameter pointer 




tfr 


U . X 


character buffer 




ldy 


#1 


one character only 




Ida 


#1 


standard output path 




os9 


i $wri te 


character to screen 




bes 


out 


exit with error 


* 


puis 


x.pc 


retrieve pointer and return 


noerr 


clrb 




clear error flag 


out 


os9 


f$exit 


quit 



****************************** 

* PROCESS DECIMAL PARAMETERS 
****************************** 



decloop 



Ida 


.x+ 


empa 


#$20 


beq 


decloop 


empa 


#') 



get character 

space? 

yes. look again 

end of decimal parameters? 



Let's look at an example of how the new 
display can be used with windows. A 
typical command to create a device win- 
dow is 

display lb 20 2 50 18 1 4 

With the new di spl ay, you could enter 

display lb 20 2 (80 24) 1 4 





ou don't 
have to convert 
decimal 
numbers to 
Hex any more 
for use with 
display. 





The first code, lb 20. is the Level ll 
escape code for creating a device window. 
The next three codes define the window 
type and starting location. The sixth and 
seventh parameters define the size of the 
window in columns and rows. The final 
three numbers indicate the screen colors. 
Notice that using decimal values with d i s - 
pi ay makes it immediately clear what size 
window is being defined. If you wanted, 
you could use decimal numbers only, as 
long as the entire group is enclosed in 
parentheses. 

For those who do not have an assembler. 
I have included a BASIC09 procedure (List- 
ing 2) that generates the display module 
and saves it in the /dd/CMDS directory. If 
you are using OS-9 Level I, use the BASlCtw 
procedure to create display, and change 
/dd at offsets S007B and Stxicx to /d0. Before 
assembling Listing 1 or running Listing 2. 
make sure you rename your existing di s - 
pi ay command. You can do this by chang- 
ing your current data directory to /dd/CMDS 
(using chd) and entering 

rename display display. old 

This display utility has made using 
control codes with the screen and printer 
much more straightforward. I hope it sim- 
plifies the way you use OS-9. too. D 
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Submitting 

Material 
To Rainbow 



Coniribuiions to the rainbow are wel- 
come from everyone. We like to run a 
variety oi programs thai are useful, help- 
ful and fun for oilier CoCo owners. 

WHAT TO WRITE: We are inier- 
ested in what you want to tell our read- 
ers. We accept for consideration any- 
thing that is well-written and has a prac- 
tical application for the Tandy Color 
Computer. If it interests you. it will proba- 
bly interest lots of others. However, we 
vastly prefer articles with accompany- 
ing programs that can be entered and 
run. The more unique the idea, the more 
the appeal. We have a continuing need 
for short articles with short listings. These 
are especially appealing to our many 
beginners. 

FORMAT: Program submissions 
must be on tape or disk, and it is best to 
make several saves, at leasi one of them 
in ASCII formal. We"re sorry, but we do 
not have time to key in programs and 
debug our typing errors. All programs 
should be supported by some editorial 
commentary explaining how the pro- 
gram works. We also prefer thai edito- 
rial copy be included in ASCII formal on 
the lape or disk, using any of the word 
processors currently available for the 
Color Computer. Also, please include a 
double-spaced printout of your editorial 
material and program listing. Do not 
send text in all capital letters; use upper- 
and lowercase. 

COMPENSATION: We do pay for 
submissions, based on a number of crite- 
ria. Those wishing remuneration should 
.«> slate when making submissions. 

For the benefit of those wanting more 
detailed information on making submis- 
sions, please send a self-addressed, 
stamped envelope (SASE) to: Submis- 
sion Guidelines, hie RAINBOW, The Fal- 
soft Building. P.O. Box 385. Prospect. 
KY 40059. We will send you compre- 
hensive guidelines. 

Please do not submit material cur- 
rently submitted to another publication. 



beq entry yes, continue with hex 

empa #'( continue decimal? 

beq decloop yes. get next character 

bsr dectobin make decimal binary 

tst dcount decimal digits? 

beq noerr no. quit display 

bsr print yes, print character 

bra decloop look for another parameter 
****************************** 

* CONVERT DECIMAL TO BINARY 

****************************** 

dectobin leax -1.x reset parameter pointer 

clrb zero value 

dcount zero digit count 

deccalc convert first digit . 

deccalc next 2 digits 

.x get character 

#•0 make binary 

#9 valid decimal digit? 

back2 no. end conversion 

a yes. save current digit 

#10 multiply previous 

total by 10 

,s+ add current digit 

#0 more than 255? 

back2 yes. end conversion 

,u no, save new total 

1.x bump parameter pointer 

dcount count digit 
return 



deccal c 



back2 



len 



clr 

bsr 

bsr 

Ida 

suba 

empa 

bhi 

pshs 

Ida 

mul 

addb 

adca 

bne 

stb 

leax 

inc 

rts 

emod 

equ 

end 



Listing 2: MakeDisplay .b09 

PROCEDURE MakeDisplay 

0000 {* Generates the binary module display *) 

0029 (* Level I - change all /dd to /d0 *) 

004E DIM path.byt:BYTE 

0059 DIM count: INTEGER 

0060 PRINT "Creating display . . .": 

007B CREATE ffpath ."/dd/emds/di spl ay" :WRITE 

0096 FOR count-1 TO 193 

00A6 READ byt 

00AB PUT tfpath.byt 

00B5 NEXT count 

00C0 CLOSE #path 

00C6 PRINT 

00C8 SHELL "attr /dd/emds/di splay e pe" 

00E8 DATA 135.205.0.193.0.13.17.129.233.0.84.1.146.68.105 

0119 DATA 115.112.108.97.249.2.40.99.41.49.57,56.56.32.83 

014A DATA 46.66.46.71.111.108.100.98,101.114.103.48.31.95 

0178 DATA 15.1.141.0.166.132.129.48.37.29.129.57.35.12.132 

01A9 DATA 223.129.65.37.19.129.70.34.15.128.7.128.48.52 

01D7 DATA 2.134.16.61.235.224.48.1.12.1.57.166.128.129.32 

0208 DATA 39.250.129.40.39.37.129.41.39.242.141.197.13.1 

0236 DATA 39.23.231.196.141.2.32.230.52.16.31.49.16.142 

0264 DATA 0.1.134,1.16.63.138.37.3.53.144.95.16.63.6.166 

0298 DATA 128.129.32.39.250.129.41.39.199.129.40.39.242 

02C3 DATA 141.8.13.1.39.232.141.213.32.232.48.31.95.15.1 

02F4 DATA 141,2.141.0.166.132.128.48.129.9.34.17.52.2.134 

0325 DATA 10.61.235.224.137.0.38.6.231.196.48.1.12.1.57 

0356 DATA 35.210.80 



/«\ 
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5 sure steps to a fast start 

as a high-paid 

computer service technician 



1 



Choose training 
that's right for today's 
good jobs 
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1992 Good pay, too! 2002 



Jobs for computer service technicians 
will almost double in the next 10 years, 
according to the latest Department of 
Labor projections. For you, that means 
unlimited opportunities for advance- 
ment, a new career, or even a com- 
puter service business of your own. 

But to succeed in computer service today, you need training- 
complete, practical training that gives you the confidence to service any 
brand of computer. You need NR1 training. 

Only NR1— the leader in career-building, at-home electronics training 
for more than 75 years— gives you practical knowledge, hands-on skill, 
and real-world experience with a powerful 386sx/20 MHz computer you 
keep. Only NR1 gives you everything you need for a fast start as a high- 
paid computer service technician. 




2 



is Go beyond 
"book learning" 
to get true hands- 
on experience 

NRI knows you learn better by 
doing. So NRI training works 
overtime to give you that 
invaluable practical experience. 
You first read about the subject, 

studying diagrams, schematics, and photos that make the subject even 

clearer. Then you do. You build, examine, remove, test, repair, replace. 

You discover for yourself the feel of the real thing, the confidence gained 

only with experience. 



3 



Get inside 
a powerful com- 
puter system 

If you really want to get ahead 
in computer service, you have 
to get inside a state-of-the-art 
computer system. That's why 
NRI now includes the powerful 
new West Coast 386sx/20 MHz 
mini tower computer as the 
centerpiece of your hands-on 
training. 

As you build this 1 meg 
RAM, 32-bit CPU computer 
from the keyboard up, you 
actually see for yourself 
how each section of yftur 
computer works. You 
assemble and test your computer's "intelligent keyboard, install the 
power supply and high-density floppy disk drive, then interface the high- 
resolution monitor. But that's not all. 

You go on to install a powerful new 40 meg IDE hard disk drive- 
today's most-wanted computer peripheral— included in your course to 
dramatically increase the data storage capacity of your computer while 
giving you lightning-quick data access. 



Plus, now you train with and keep the latest in diag- 
nostic hardware and software: the R.A.C.E.R. plug-in 
diagnostic card and QuickTech diagnostic software, 
both from Ultra-X. Using these state-of-th<Nirt diag- 
nostic tools, you learn to quickly identify and ser 
vice virtually any 
computer problem 
on IBM-compat- 
ible machines. 



* 




■!■ Make sure you've always got 
someone to turn to for help 

Throughout your NRI 
training, you've got the 
full support of your 
personal NRI instructor 
and the entire NRI 
technical staff. Always 
ready to answer your 
questions and help you if 
you should hit a snag, 
your instructors will 
make you feel as if 
you're in a classroom of 
one, giving you as much time and personal attention as you need. 




5 




Step into a bright new future in 

computer service— start by sending for 
your FREE catalog today! 

Discover for yourself how easy NRI makes it to 
succeed in computer service. Send today for NRI 
big, full-color catalog describing every aspect of 
NRI's one-of-a-kind computer training, as well as 
training in TV/video/audio servicing, telecom- 
munications, industrial electronics, and other 
growing high-tech career fields. 

If the coupon is missing, write to: NRI 
School of Electronics. McGraw-Hill Continuing 
Education Center, 4401 Connecticut Avenue, NW, 
Washington. DC 20008. 

R.A.CE.R. and QuickTech arc registered trademarks ol Ullra-X. INC 




School ol 
Electronics 



3K 

i:nii 



McGraw-Hill Continuing Education Center 

4401 Conneclicul Avenue, NW, Washington, DC 20008 

/CHECK ONE CATALOG ONLY 
Microcomputer Servicing 

J TV/Video/Audio Servicing 

] Telecommunications 
□ Industrial Electronics/Robotics 
[ 1 Basic Electronics 



F« career courses 

approved under Gl Bill 

72 check lor details. 
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D Computer Programming 
1 3 PC Software Engineering Using C 
D Desktop Publishing & Design 
D Word Processing Home Business 
D Bookkeeping & Accounting 



I Name 

I Address 

| City 

I 



State . 
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Accredited Member. National Home Study Council 
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The definitive word on using 
the MPI with the CoCo 3 



pgrade 

Your /Wulti-Pak 



by Marty Goodman 




ver the last few years in fea- 
ture articles and columns in 
THE RAINBOW, and in many 
replies on Delphi's CoCo SIG. 
I've commented on the need 
and the means for upgrading the Multi-Pak 
Interface (MPI) for use with the CoCo 3. 
However, until a few weeks ago I never had 
a clear understanding of exactly why the 
Multi-Pak upgrade is necessary. This was 
reflected in my somewhat waffling approach 
to questions about whether unupgraded 
Multi-Paks that appeared to work properly 
with the CoCo 3 should be upgraded. 
Another question was whether failure to 
perform the upgrade could injure either the 
CoCo 3 or the MPI itself. 

A few weeks ago I was asked to consult 
with a major Color Computer vendor re- 
garding a proposed new CoCo product: A 
buffered Y cable for the CoCo 3. In the 
course of looking over the design and 
making some suggestions for improving it 
prior to production. I had to increase my 
understanding of just what the upgrades did 
for the Tandy Multi-Pak Interface. As a 



Martin H. Goodman, M.D., a physician 
trained in anesthesiology, is a longtime 
electronics tinkerer and outspoken com- 
mentator — sort of the Howard Cosell of 
the CoCo world. On Delphi. Marty is the 
SIGop of rainbow's CoCo SIG. His non- 
computer passions include running, moun- 
taineering and outdoor photography. Marty 
lives in San Pablo. California. 



result. I can now provide more-definitive 
information to other CoCo users. 

The Bottom Line *m"*«"*«i"i* ► 

The very earliest of Tandy Multi-Paks 
(those with Catalog Number 26-3024 that 
were in gray plastic cases) simply do not 
work with a CoCo 3 without the upgrade. If 
you put a disk controller into Slot 4 and plug 
the MPI into a CoCo 3, you will not even get 
the Disk Extended BASIC message when 
you power up the system. Instead, you get 
the Extended BASIC message. 

The oldest release of the MPI had its slot- 
select address ghost from its official loca- 
tion at SFF7F to Location SFF9F — any at- 
tempt to write data to SFF9F affects which 
Multi-Pak slot is selected. The ghosting to 
SFF9F was never a problem with the CoCo I 
and 2. Those models of the Color Computer 
did not use that address internally, and 
developers of add-on cards knew to stay 
away from Location SFF9F in the I/O address 
space when designing CoCo hardware. 
However, the GIME chip in the CoCo 3 uses 
address SFF9F as part of its horizontal-offset 
register for video. 

When the CoCo 3 powers up. it initial- 
izes all the GIME chip registers, including 
the one at SFF9F. The attempt to initialize 
this register causes the older MPI to switch 
away from Slot 4 where the disk controller 
resides. Any subsequent writes to the hori- 
zontal-offset register of the GIME chip fur- 
ther messes with the Multi-Pak's slot selec- 
tion. Thus, owners of the earliest models of 
MPI from Tandy quickly found they abso- 



lutely had to upgrade their Multi-Paks. This 
is done by replacing the socketed PAL chip 
with a newer, specially designed PAL. 

Some of the newer 26-3024 Multi-Pak 
Interfaces (those in a white case) and all of 
the (smaller) 26-3124 MPls do not ghost 
Address SFF7F to Address SFF9F. When 
connected to a CoCo 3. with the disk con- 
troller in Slot 4, these units appear to work 
properly. The question, then, is should these 
units be upgraded? The answer is simple — 
yes! All Multi-Paks being used with the 
CoCo 3 should he upgraded. 

Why Must We Upgrade? (Minimi* 

The Multi-Pak Interface from Tandy 
buffers all address and data lines on the 
Color Computer system bus. Since address 
lines carry data in only one direction (from 
the 6809 to the rest of the system), buffering 
them presents no problem. However, data 
lines are bidirectional and therefore require 
a buffer that operates in both directions. 

The data buffer used on the data lines in 
the MPI is connected to a control line called 
the R/w (Read/Write) line, which tells the 
data buffer (a 74LS245 chip) which direction 
the data is supposed to go. Both the Color 
Computer 3 and the Multi-Pak Interface 
have such data buffers. 

As long as you do not use hardware 
cards that have ports in the I/O address space 
now reserved for the GIME chip, no prob- 
lems arise with an unupgraded MPI during 
attempts by the 6809 to write data. However, 
problems do occur when using a Multi-Pak 
(even one with no cards in it) if the 6809 
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attempts to read data from ports of the GIME 
chip in the range SFF80 through SFFBF. The 
reason is simple: Multi-Paks have never 
heard of a GIME chip, and they assume the 
address space in the range SFF80 through 
SFFBF is available for general-purpose I/O. 
Thus, they allow their data buffer to be 
active when a read operation is performed 
by the 6809 in that address range. The result 
is that attempts to read the contents of GIME 
chip registers can get garbled because both 
the GIME chip and the 74LS245 data buffer in 
the Multi-Pak are trying to place data on the 
6809 "s system bus at the same time. It doesn't 
matter that there may be no device in the 
MPl addressed in that range — the 74LS245 
buffer in the Multi-Pak remains active, 
putting random garbage data onto the data 
lines, which conflicts with the valid data the 
GIME chip is trying to send to the 6809. 

The upgrade involves altering control 
over the 74LS24S data buffer in the Multi- 
Pak so that it is effectively taken out of the 
circuit preventing both read and write op- 
erations with the SFFSO-SFFBF address range 
reserved for the Multi-Pak. Technically 
knowledgeable types will know that this 
means putting the 74LS245 into the tri-state 
mode, with all its pins at a high impedance 
level. Note that the data buffer in all models 



of the MPI is already tri-stated for all 6809 
addresses except those decoded by the *CTS 
select (SC(KX) through SFFDF). the *SCS ad- 
dress space (SFF40 through SFPSF). and the 
general-purpose I/O address space of SFF60 
through SFFBF. The upgrade narrows the 
valid general-purpose I/O range from SFF60 
through SFFBF to SFF«) through SFF7F. which 
excludes the address range reserved for the 
GIME chip in the CoCo 3. 

Using unupgraded Multi-Paks that ap- 
pear to work correctly with the CoCo 3 can 
result in problems with any software that 
attempts to read registers in the MPl. Hap- 
pily . I can assure you that although you may 
run into some subtle flakiness in CoCo 3 
performance, using an unupgraded Multi- 
Pak will not in any way injure either the 
CoCo 3 or the MPl. The brief data conflicts 
between the 74LS245 buffers in the CoCo 3 
and the Multi-Pak wilt not physically dam- 
age either buffer chip or any other chips in 
either device. 

The Upgrade •*'"" ► ► ► 

The actual upgrade is achieved in one of 
two different ways, depending on whether 
you have a 26-3024 or 26-3124 MPl. If you 
have the older (26-3024) Multi-Pak, you first 
buy a new 20-pin PAL chip (available from 



Upsrading the 26-3124 MPl 



To upgrade the newer 26-3124 Multi- 
Paks for operation with a CoCo 3 requires 
that you construct and install a small sat- 
ellite circuit board. 

Construction: 

1 ) Mount a 74LS10 (or 74FI0) chip on a 
small circuit board. 

2) Connect a 6-inch length of red wire 
to V cc (Pin 14). 

3) Connect a 6-inch length of black 
wire to the Ground pin.(Pin 7). 

4) Wire a .1 uFd capacitor between 
pins 7 and 14. 

5) Connect pins I, 2 and 3 together, 
and connect this to one side of a 1 000-ohm, 
'/■-watt resistor. 

6) Connect the other side of the resis- 
tor to Pin 14 (V cc ). 

7) Connect Pin 12 to Pin 4 of the chip. 

8) Connect Pin 8 to Pin 5. 

9) Connect 6-inch lengths of wire to 
pins 6. 9. 10. ll and 13 of the 74LS10. 



Installation: 

1 ) Cut the trace that joins Pin 52 of IC6 
with Pin 19 of 1C1 on the MPI motherboard. 

2) Connect Pin 6 of the 74LSI0 to Pin 19 
of ICI. 

3) Connect Pin 1 3 of the 74LS 10 to Pin 52 
of IC6. 

4) Connect Pin 9 of the 74LS 10 to Pin 1 1 
of IC4. 

5 ) Connect Pin 10 of the 74LS l o to Pin 9 
Of IC4. 

6)ConnectPin ll ofthe74LSl0toPin3 
of IC4. 

7) Connect the red V cc wire from the 
74LSK) to a source of +5 volts, such as Pin 
16 of IC5. 

8) Connect the black Ground wire to 
ground on the Multi-Pak motherboard. 
Pin 8 of tCS is one such ground spot. 

9) Mount the satellite board in a me- 
chanically sound fashion inside the Multi- 
Pak. Make sure it cannot rattle around and 
cause shorts in other parts of the unit. 



Tandy National Parts, CoCo PRO! and 
Microcom). Then open the MPl. remove the 
old PAL (it is the only socketed chip) and 
replace it with the new PAL. 

The upgrade required for the 26-3124 
Multi-Pak is a little more difficult. Instead 
of simply replacing a chip, you must patch 
the data-buffer-enable circuitry by cutting 
a couple of traces and adding a specially 
prepared 74LS10 chip. The exact circuit for 
this upgrade was presented in a previous 
rainbow article ("Quick Fixes," October 
1988, Page 58) and is also posted on Delphi 
in the CoCo SlG's Hardware Hacking data- 
base. However. I'll give you a quick de- 
scription of the upgrade here (see sidebar). 
If you encounter problems, refer to the 
rainbow article or to the schematic posted 
on Delphi. 

Related Topics '""♦'"»♦""•+• ♦•unHum* 

One final tip on the subject of CoCo 3's, 
data buffers, and the MPI: OS-9 users who 
want to decrease the chance that subtle 
liming differences will cause problems, and 
who are experienced hardware hackers, 
might want to consider replacing the 74LS245 
chips in the CoCo 3 and the MPL (There is 
only one 74LS245 in either unit. The one in 
the CoCo 3 is labeled IC3 and is located right 
next to the 68B09E.) In the past. I have 
recommended people use 74F245S as re- 
placements. However. Bruce Isted has in- 
formed me these chips may or may not 
work properly. Instead, replace the 74LS245S 
with 74AS245S. 74LS645S or 74ALS645S. (For 
more information, see this month's "CoCo 
Consultations.") To do this, desolder the 
existing 74LS245S, install sockets and plug 
in the new chips. 

Those who do not have a Multi-Pak 
Interface, but need one to simultaneously 
operate a disk controller and other cards, 
have several alternatives: 

1) In the CoCo and OS9 Online SIGs on 
Delphi are classified-ads sections where 
many used Color Computer items are of- 
fered. Multi-Paks are often among those 
items. 

2) Howard Medical sells the Slot Pak III. 
a Multi-Pak-like device. 

3) Many rainbow vendors sell Y cables, 
which will do for simple situations, such as 
one disk controller and one RS-232 Pak. 

4) CoCo PRO! may soon offer a buffered 
Y cable (which was the impetus for my 
writing this article in the first place). 

Happy Hacking! See you all on the 
Delphi CoCo and OS9 Online SIGs. /«\ 
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Printer Utility 



CoCo3 



MiniBanners 

MiniBanners is an easy-to-use banner- 
making program written for the CoCo 3 
with a disk drive and a printer. The program 
is menu-driven and supports both the 40- 
and go-column screen formats. Version 1.1 
contains 36 fonts, and others can be easily 
added. The various fonts included, such as 
Broadway. Byte. Colossal. Future, Gothic. 
Italics. Roman, and Small provide your 
customized banner with unique styles. The 
program also lets you select the character 
used to form the message on your banner. 
This can be any character between ASCII 32 
and 255. For instance if you want the letters 
to be formed out of asterisks (*). you would 
use 42. 

MiniBanners allows you to print single- 
. double-, or multi-line banners on virtually 
any printer, including daisy-wheel printers. 
If you happen to have a printer that isn't the 
standard xo-column width, you can still use 
MiniBanners — one of the menu options 
lets you select your printer's printing width. 
A Font-Width option lets you determine 
how wide each letter on your banner should 
be. The Line-Spacing option is used to 
create space between printed lines on mul- 
tiple-line banners. Also a Height option can 
be used to tell MiniBanners how tall to 
make each of the banner letters. 

Defaults are used in MiniBanners so you 
can print a standard one-line banner with- 
out entering anything other than the banner 
message itself. The program automatically 
senses a multi-line banner if you type in a 
number smaller than the default. 

MiniBanners' Main menu also lets you 
select the Configuration mode, so you can 
change the defaults to whatever you want. 
You will use this option to enter your 
printer's baud rate or to change any of the 
other displayed settings. When you are done, 
you can save the defaults to disk. 

The Main menu and Configuration 
screens are clean, uncluttered, and self- 
explanatory. Both the 40- and so-column 
screens are white on black and are sharp on 
my Tandy CM-s monitor. 

MiniBanners is not copy protected, so 
you can make a backup for your own pro- 
tection. The six-page instruction booklet is 



well-written and easy-to-follow. MiniBan- 
ners is a nice addition to any CoCo 3 user's 
software library. I especially liked the multi- 
line printing capability, which is unique for 
a program of this type, and the many user- 
controlled inputs allow really nice-looking 
banners. 

(Sub-Etha Software, P.O. Box 152442, 
Lufkin. rx 75915; $19.95 plus $2.50 s/H) 

— Jerrv Semones 



Home Help 



CoCo 3 



CheckBook+ 

When people buy a computer, often one 
of the first chores relinquished to it is bal- 
ancing the checkbook. CheckBook+, as its 
name implies, is a program designed to 
accomplish this task. 




The Plus (not to be mistaken as a special 
money-generating feature) stands for the 
extra features added to this program that 
separate CheckBook+ from other "vanilla" 
checkbook packages. These extra features 
include: A point-and-click interface; pull- 
down menus: a pop-up calculator: the op- 
tion to graph data by the month or year 
using bar. line, or pie graphs; and a variety 
of ways to sort checks alphabetically and 
numerically, such as by company, item or 
amount. 

The point-and-click interface works well. 
However, writing programs that require 
another commercial product (the Tandy 
High-Resolution Joystick Interface in this 
case) can limit your audience. Most func- 
tions require just a point-and-click. with the 
exception of some check, graphics, calcula- 



tor, and file-naming tasks. This interface 
makes the program very easy to use. and 
you could essentially be using CheckBook+ 
even before looking over the manual. 
However, the well-written nine-page man- 
ual does cover a handful of nonapparent 
features, so do take the few minutes neces- 
sary to read it. (Or you may end up like I did 
— stuck wondering how to get out of the 
pop-up calculator.) 

A checkbook program wouldn't be 
complete without a calculator. A handy 
feature of the calculator built into Check- 
Book+ is its ability to store a total, even 
after the calculator has been closed, allow- 
ing you to search for checking information 
then reenter the calculator and use a previ- 
ous total. There are times when the calcula- 
tor isn't necessary because graphics can 
display the information faster. 

If you have an open file containing a 
minimum of three records, the graphics and 
sort options are accessible by clicking on 
the Special menu box. You can create a 
graph of information related to withdraw- 
als, deposits ortotals. from selected months 
or years. Simply enter the specific time 
frames and choose between a circle-, bar- 
or pie-graph presentation. 

The sort options reposition the check 
entries several different ways, both alpha- 
betically and numerically. Of course, be- 
fore using these fancy options, you do have 
to perform the mundane task of entering the 
checking information. 




Deposits show the date and amount. 
Withdrawals and checks can include date, 
amount, recipient and description informa- 
tion. Records are saved to disk and can be 
printed. Editing is accomplished by mov- 
ing individual records onto a clipboard. 
Once on the clipboard, the record can be 
cut. copied, inserted, appended, or replaced. 
Available options appear in black, with 
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unavailable options shown in a grey high- 
light. A search routine helps you locate 
specific records quickly. 



1 he extra 
features 
separate 
CheckBook+ 
from other 
"vanilla" 
checkbook 
packages. 



CheckBook+ can handle large files. The 
workspace accommodates files consuming 
more than one disk. Saving and loading 
files of this size is accomplished by swap- 
ping disks. With this process, you can use, 
at maximum, a file filling ten disks. 

Using CheckBook+ is simplicity itself. 
The screen display is uncluttered and ap- 
pealing to the eye. If you want to change the 
screen-text font to one you already own 
(normal and IBM fonts are included with the 
package), you need to change the extension 
to .FNT. Fonts supplied with the MiniBan- 
ners program (reviewed in this issue) also 
work with CheckBook+. 

Checkbook* requires a CoCo 3, one or 
more disk drives, a Tandy High-Resolution 
Joystick Interface, and a mouse or joystick. 
It works with either a composite or RGB 
monitor, and supports output to a printer. 
CoCo 3's with 5 1 2K provide more room for 
in-memory transactions. Otherwise all 
functions are identical for 128K users. 

In a nutshell, this a another fine program 
from Joel Matthew Hegberg. 



Editors Note: Sub-Etha is working on OS-v 
versions of both MiniBanners and Check- 
Book+. Call or write for more information. 

(Sub-Ktha Software, P.O. Box 152442, Lufkin. 
TX 75915, 409-639-3842; $24.95 plus $2.50 

S/H) 

— Jamie Hensen 



Self-Education 



CoCo1.2&3 



MicroMessage #1 

MicroMessage #1 is a bible-study pro- 
gram on disk. Simplicity and ease of use are 
its outstanding characteristics. The Main 
menu is always in view at the bottom of the 
screen, and you use the up- and down- 
arrow keys to advance through the pages of 
the study, one third of a page at a time. You 
can also move to any desired page by using 
only two keystrokes. The user may print 
any portion of the text or the whole study. 
This feature works flawlessly, as does the 
rest of the program. The study includes 19 
pages of text. 

MicroMessage #1 works on any CoCo 
with at least 64K, and requires a disk drive 
and printer. Because of the lack of screen 
clarity of televisions and color-composite 
monitors, a monochrome or RGB monitor is 
highly recommended. The documentation 
is only two pages but is quite adequate, and 
I encountered no difficulties whatever in 
using the program. 

The particular study I reviewed was on 
the subject of prayer and covers Matthew 
6:5-51. It would have been helpful if that text 
had been printed on the disk label, which 
instead simply carried the title "Prayer." As 
a working pastor with some thirty years 
experience. 1 found the study helpful. It 
begins with a couple of illustrations of 
prayer, proceeds with a verse-by-verse study 
of the text, and in the third section analyzes 
the words of the text by parts of speech and 
usage. The New Testament was originally 
written in Greek, so any in-depth study 
must consider the meaning of the original 
wording. 

For a Pastor or serious bible student. 



MicroMessage #/ can save a lot of work. 
The study presents the user with a gram- 
matical analysis of each keyword and in- 
cludes references to where and how the 
word is used elsewhere in the New Testa- 
ment. In short, the study proceeds just as 
any study should, and it does most of the 
routine work for the user. 

I give MicroMessage ttl high marks for 
ease of use and competence of work. I 
would like to have a disk for any text on 
which I am to preach! At five dollars per 
disk, it is a bargain. 




(BDS Software, P.O. Box 485. Glen view, n. 

6(1025-0485; $5) 

— The Rev. Dr. Richard A. Olsson 



Game 



CoCo 3 



Monster Mash 

Monster Mash is an action-packed ar- 
cade game written for the CoCo 3 with a 
disk drive. It requires a joystick, and the 
graphics look best on an RGB color monitor, 
though the game supports color-composite 
monitors, as well. The program is written in 
machine language and features excellent 
16-color. Hi-Res graphics that are reminis- 
cent of some popular Nintendo games. 

Loading Monster Mash is as simple as 
inserting the disk in the drive, and loading 
and executing the machine-language pro- 
gram. The title screen appears and an intro- 
ductory tune is played. You must leave the 
disk in the drive during game play because 
frequent calls are made to load more screens. 

In Monster Mash, you play the part of 
Kerwin. whose task is to find and conquer 
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the evil Medusa who has controlled the 
village for many years. The villagers had 
previously sent four of their strongest and 
bravest warriors to confront Medusa. They 
never returned because they had been trans- 
formed into hideous plant-like creatures. 
The magic mirrors they possess were bro- 
ken during battle, but can be reassembled 
into one piece and used to defeat Medusa. 
The transformed warriors are willing to sell 
the pieces of mirror, but they want gold in 
exchange. 

To win Minister Mash you must find the 
four transformed warriors and 10 sacks of 
gold before you can confront Medusa. There 
are some 70 rooms you can visit, and all are 
connected by doors so a map is vital if you 
want to do well. A map of the village is 
supplied in the two-page instruction man- 



ual but you will need to make a more 
detailed map as you venture into strange 
territories. 




Kerwin is armed with magic swirls that 
can be fired with the joystick button. Ker- 



Plug-N-Go... 
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NX-1001 



MULTI-FONT 




RAINBOW 

NX-1020 

This next generation color printer sets new 
standards in color printer performance... 225 
cps, 4 NLO fonts including Script, plus a new 
high speed draft font; but the enhancements 
don't stop there. Add a 16k buffer, a special quiet 
mode, top feed, bottom and rear tractor, and the 
list goes on. Seven on-demand colors, 8 color 
graphics modes, Epson and IBM emulation for 
maximum software compatibility. Virtually 
everything desired in a printer is here - speed, 
color and versatility dX an affordable price with a 
2 year warranty. 

OUR PLUG W GO FOR THE COCO 
SYSTEM INCLUDES: 

• NX-1020 Rainbow Multi-Font Printer 

• Blue Streak Ultima $0/1 Q 95 

• Software Support Disk L.^r\j 

• Color Super Gemprint ,SI0 Shipping & Insurance 



Order Your System Today... Call (513) 885-5999 

All Dayton Associate's products have a 30 day moneyback guarantee. 
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enhanced version of 

the legendary NX-1 0001 1 is the 

latest low-cost high-performance printer 

from Star Micronics. Fully featured with 4 NLQ 

plus a draft font. 10 character sizes from 

subscript to quadruple size, 4k buffer, 180 cps, 

friction and tractor feed, and much much more. 

Backed by a 2 year warranty. Epson and IBM 

emulation modes for maximum software 

compatibility. A performer so versatile you may 

never exhaust it's creative possibilities. 

OUR PLUG W GO FOR THE COCO 
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• NX-1001 M li Iti Font Printer 

• Blue Streak Ultima $ «4 Q QRR 

• Software Support Disk -. 
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win has eight lives, which are displayed as 
hearts and are used up as he falls or gets hit 
by the evil guards, which are in the form of 
bats, floating mummies and Jack-O-Lan- 
terns. The action is smooth, and Kerwin is 
easy to maneuver. Only a short delay of 
four to eight seconds halts game play when- 
ever a new screen ' s loaded. This can be 
eliminated if you have 5 1 2K and a RAM disk, 
allowing quicker screen changes. If you 
need, you can pause game play with the P 
key. 

There are a lot of other features in 
Monster Mash that make it a real challenge 
and fun-to-play. You"ll have to play the 
game in order to discover some of these 
other surprises. I can assure you that you 
won"t find it boring. 



(Biware Enterprises, c/o Kandi Stinson, 
Box 265, Allen, OK 74825; $22) 



Robert Gray 



Game 



CoCo3 



Deception Path 

Deception Path is a plainly pleasant, 
provocative, positively perplexing puzzle 
phenomena. It is solved as easily as saying 
the previous sentence three times in rapid 
succession without tripping over your 
tongue. In essence, all you have to do is 
navigate through the passages of a maze, 
pick up designated treasures, and return. 
There are no monsters to slay, bombs to 
avoid, spells to be cast or time limits to 
meet. So whafs the big deal, you ask? The 
problem is that the passages continually 
change, and what looked like an easy path 
to your treasure is suddenly a dead end. 
forcing you to search or build another path. 

The playing field, or maze, consists of a 
7-by-7 grid and .so playing tiles. This means 
there is always one extra tile, which sits 
outside the maze, with a passage on it. 
Using the joystick, the free tile can be 
rotated and positioned on the perimeter of 
the maze and slid into a new row or column. 
If strategically done, this will allow you to 
advance your playing piece and reach your 
assigned treasure. 

The game can be played by one to four 
players. Each player is allowed, in turn, to 
shift or rotate one tile or portion of the 
playing field. Doing this will (hopefully) 
enable him to reach the treasure. In the case 
of a single-player game, the computer (in 
its diabolical way) randomly rotates a 
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number of liles. often ruining the best laid 
plans. 

Each player has an onscreen status box 
that displays objects retrieved and the next 
treasure to be picked up. A color bar at the 



kJ eception 

Path is a plainly 

pleasant, 

provocative, 

positively 

perplexing 

puzzle 

phenomena. 



lop indicates whose turn it is. but does not 
allow a player's name to be entered. Each 
player has to remember the rotation of his 
turn or his designated color. The game ends 
(without any fanfare, fuss or ado) when 
every player has found and retrieved his 
treasures. There are no scores, timers, bells 
or whistles when the task is completed. It is 
somewhat like running the marathon: just 
finishing is reward enough. While the lack 
of a score takes away the challenge to better 
oneself in a future game. Deception Path is 
a cute, non- violent game that requires some 
strategy and a bit of luck, and is a delightful 
wayofspendinganhourwiihyourCoCo.lt 
does require a CoCo 3. a disk drive and a 
joystick. 



(Eversoft Games Ltd., P.O. Box 3345, 
Arlington, W A 98223-3354; $19.95, plus $2.50 
S/H) 



— George Aftamonow 



Programming 



OS-9 



Math.l Supplement 

I am pleased to report that I have re- 
ceived a supplement to the Math. I library 
from Bits-N-Bytes. In my previous review 



of the Math.l library (April 1991, Page 66), I 
complained about the lack of a functional 
index and the lack of a header file to proto- 
type each of the math functions. The lack of 
a header file forced the programmer to 
manually prototype each math function. 

Included with the supplement is a plas- 
tic-coated quick-reference card listing all 
of the math functions and the page number 
on which the function appears in the man- 
ual. Also included on the quick-reference 
card is a complete function prototype list- 
ing the data types for parameters and the 
data type of the returned value, as well as 
the valid range of parameters. The quick- 
reference card is a very nice touch that I 
think is above and beyond the call of duty, 
per se. The inclusion of this information at 
the back of the manual would have sufficed 



nicely, but I'm not going to complain lest 
Bits-N-Bytes changes its mind. 

The disk includes a math . h file that not 
only contains the prototypes for each of the 
math functions, it also defines alternate 
names for the math functions. Instead of 
using csc( ) and csch( ). for example, you 
can use cosec( ) and hypcosect ). Although 
the original version of the math library was 
a nice addition to your C library, it is even 
better with the quick-reference card and 
header file. 



(Bits-N-Bytes, 4046 Wilson Creek Road, 
Port Orchard, \v.\ 98366; included with 
Math.l package) 



— Greg Law 
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Grey level shading lor color 



SUPER 
GEMPRINT 
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SUPER 
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The following products have recently been received by THE RAINBOW, examined by 
our magazine staff and issued the Rainbow Seal of Certification, your assurance 
that we have seen the product and have ascertained that it is what it purports to be. 



CoCo Tools, a comprehensive set of disk 
utilities for Disk BASIC. File commands 
allow you to: Archive, copy. kill. edit. move, 
compare, purge, rename, salvage and un- 
archive files. Disk commands available 
support: Backup, directory, gran analysis, 
disk edit, initialize disk, rejuvenate disk, 
verify, erase, write sorted directory and 
disk-speed check. Over a dozen other op- 
tions included. Multiple-fileoperationscan 
be carried out with a few keystrokes. CoCo 
Tools has automatic diagnosis and repair 
capabilities for fixing file-allocation errors 
and directory information. Allows for a 
start-up configuration of display colors, 
printer baud, step rate and directory-sorting 
preferences. Requires a CoCo 3. a disk 
drive and a monitor capable of displaying 
so-column text. Cer-Comp LTD. 5566 
Richochel Avenue. Las Vegas. NV 89110, 
(702) 4S2-0632; $49.95 plus U SIB. 

.g. Sidney, the Super Space Snake, a 

^ fast-paced arcade game with 16-color 
Hi-Res graphics. The object of the game is 
to help Sidney escape the floating Electro- 
Prison by consuming Electropods. You must 
survive 33 increasingly difficult sub-levels 
to win the game. Features include game 
pause, unlimited "continues'* and high 
scores retained on disk. Requires a CoCo 3. 
a disk drive and an RGB monitor. KLG 
Systems. 38 Clove Rd. tt204. Monroe. NY 
10950, 1914) 783-2950; $14.95 plus $2 SIH. 

HideScreen t.o. hides CoCo 3 graphics 
screens in unused memory locations. 
Screens can later be recalled. Hides 13 
HSCREENZ or HSCREEN4 screens, 26 HSCREEN1 
orHSCREEN3whenusedwitha?i2KCoCo3. 
half these amounts with a 256K machine, 
and only one HSCREEN1 or HSCREEN3 screen 
in I2XK. It is strongly recommended you 
have 256K or 5I2K when using this utility. 
Complete with graphics demo (at least 256K 
required to run the demo). N*.Iolinson 
Software. 5830A Reiuke Drive. Crestview, 
Fl. 32536. (904) 682-2907; $7.95. 



CoCo Cassette #107. a variety of pro- 
grams presented monthly for the CoCo 1 . 2 
and 3. This month includes: Desert Storm, 
you are commander-in-chief in this battle 
simulation: Business Profit Planner, proj- 
ect expenses for starting your own business: 
The Ultimate Ruler, see how well you can 
manage a small Agrarian society: Math 
Derby, an educational program for begin- 
ning math students: Blood Pressure Data- 
base 3, keep track of your blood pressure 
throughout the day or week; Cobra Attack, 
a graphics helicopter attack game: Mono- 
gram, a program that draws a large mono- 
gram for fancy letterheads: Country Club 
Adventure, a text adventure: Screen Blanker, 
automatically blanks the screen if the 
computer is unattended for over a minute: 
and Color Golf, a Tom Mix favorite for one 
to four players. T&D Software. 2490 Miles 
Standi sh Dr.. Holland. Ml 49424. (616) 399- 
9468; $8. 

CK83 Forth, a i')S3-slandard Forth operat- 
ing system/programming language for the 
64K CoCo 2, or a CoCo 3. with at least one 
disk drive. CP83 itself includes only the 
required word set for the Forth-83 standard. 
BDS Software. P.O. Box 485. Glenview. IL 
60025-0485; $17. 



CF83-3 Block F.ditor. CF83 Faith's screen- 
oriented block editor. Use of this product 
requires that you have CF83 Forth, also 
from BDS Software. BDS Software. P.O. Box 
485, Glenview. IL 60025-0485; $18.95. $15.00 
with the manual on disk only. 

CF83-1 Technical Reference Manual, this 
is the detailed reference for CF83 Forth. As 
such, it is intended for users of CF83 Forth. 
also from BDS Software. This manual can 
be purchased in hard-copy form or on disk 
only. BDS Software. P.O. Box 485. Glenview. 
IL 60025-0485; $17.25. $10.00 for the disk 
version. 

^ Discaide. a utility program for analyz- 
^ ing disk data. A few of the features 
included are: Inspection of an OS-9 disk 
while in Disk BASIC; listing allocated gran- 
ule information: clear sector garbage: 
maximizing use of disk space; and list 
complete directory, including first granule 
and end bytes. Requires a 35-track disk 
drive. Disk BASIC l.l or 2.1 (a CoCo 2 or 
CoCo 3). and a printer. The Homchiz Fun- 
ware Company. 48 South llth St.. Richmond. 
IN 47374; $24.95. $19.95 introductory offer. 



First product received from this company 



The Seal of Certification is open to all manufacturers of products for the Tandy 
Color Computer, regardless of whether they advertise in nil-: rainbow. 

By awarding a Seal, the magazine certifies the program does exist — that we have 
examined it and have a sample copy — but this does not constitute any guarantee 
of satisfaction. As soon as possible, these hardware or software items will be 
forwarded to THE RAINBOW reviewers for evaluation. 
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Music Tutor 



by William K. Miller 



L 



'earn to read 
music with a CoCo quiz for every good 
boy (or girl) who does fine 
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A 


general FOR/NEXT variable 


BC$ 


bass-clef notes 


BF 


graphic buffer 


CC 


flag for bass/ireble clef 


JP 


joystick value 


KN 


keyboard/note Hag 


MS 


message number 


MS$() 


screen message array 


N 


position in note string 


N$ 


current note string 


NO 


note values in CoCo formal 


NN 


vert, position for graphic 


N0$ 


current note for play 


NT 


target keyboard position 




for note displayed 


OC 


octave 


0C$ 


octave for play 


OE 


odd/even Hag 


PL 


random position in N( ) 


PX 


horizontal screen position 




lor messages 


PY 


vertical screen position 




for messages 


Q$ 


IN key variable 


T 


general for/next variable 


TC$ 


treble clef notes 


TN 


length of nole siring 


X 


horiz. position of graphic 


Y 


vcn. position for graphic 


Z 


general FOR/NEXT variable 


Figure 


1: Program Variables 



A short time ago my daughter 
decided to learn how to play 
the organ. The keyboard on 
our organ is divided into 
three levels: Two rows of 
keys and one level of foot 
pedals. Generally the upper keyboard is 
used with the right hand to play the melody 
in the treble clef. The lower keyboard is 
used with the left hand to play chords in the 
bass clef. The foot pedals are used for notes 
in the bass clef that are played with the 
rhythm. 

For the beginner, all these keys, pedals 
and corresponding notes can be somewhat 
overwhelming. When playing the music, 
there is no time for the student to think 
"This note is middle C. It is the note to the 
left of these two black keys." I decided to 
write Note Tutor to assist my daughter in 
learning the correlation between the writ- 
ten notes on a sheet of music and the corre- 



Williani K. Miller is a teacher of special- 
needs students. He enjoys using his com- 
puters, two CoCo 3's and a Tandy 1000, to 
write programs for his children and his 
students. He can he contacted at 19 Bare- 
foot Hill Road. Sharon. MA 02067. Please 
include an SASE when requesting a reply. 



sponding keys on the keyboard, as well as 
learning of the name of each note. 

Note Tutor is designed to place a ran- 
domly selected musical note on a staff. The 
student then either names the note or indi- 
cates which key goes with the note. This is 
done using either a mouse or a joystick to 
move a pointer to the correct key/pedal. 



Lines 


Description 


10-130 


set screen requirements and 




dimension buffers and variables 


140-560 


draw graphics on screen and 




place in buffers 


570-730 


display user choices onscreen 




and get responses 


740-780 


main loop: pick random note 




from Array N ( ) 


790-850 


determine octave of selected 




nole and set 0C* for use with 




the play command 


860-940 


determine which graphic (odd/even 




and stem up/stem down) to use 


950-980 


display graphic. PLAY the nole 




and jump to Line 1010 for 




position or Line 1 120 for naming 


990-1040 


get user response for note or 




Quit, and check for right/wrong 


1050-1110 


clean the screen and jump to get 




another random note (Line 770) 


1120-1170 


joystick input for position 




and keyboard for Quit checked 


1180-1190 


set target position for 




joystick cursor and check user 




response from mouse/joystick 


1200-1230 


handle incorrect response 




from mouse/joystick and jump to 




Line 770 for another note 


150-290 


subroutines: 




a) get key pressed 




b) print message MS from 




Array hsjo at px.py 




c) erase message 


Figure 1 


: General Program Breakdown 



The CoCo 3 is ideally suited for this task 
because it allows programs to mix graphics 
and text, provides a sound output, and ac- 
cepts mouse or joystick input. I hope the 
learning process will become more auto- 
matic when you start using Note Tutor. 

General Instructions 

After the program starts, a musical staff 
appears onscreen in the upper-left corner, 
and a dialog box appears in the upper-right 
corner. The two keyboard rows and the 
pedals appear in the lower part of the screen. 
At this introductory screen, the dialog box 
prompts the student for which clef he wants 
to use, treble or bass. The student makes 
this choice by pressingTorB. The range for 
the treble clef is three octaves, starting from 
F below middle C. This range is covered by 
the upper keyboard on the screen. The bass 
clef is covered by the lower keyboard and 
pedals, and ranges from F above middle C 
to more than three octaves below that. 

After selecting the clef, the user is asked 
whether he wants to name the notes ran- 
domly shown on the staff or indicate their 
positions on the keyboard. This choice is 
made by pressing N to name the notes, or K 
to indicate keyboard positions. If the stu- 
dent presses N in response to this prompt, a 
randomly selected note appears on the staff. 
He must then press the key that corresponds 
to the musical name of the note. If the note 
is correctly named, the note is omitted from 
subsequent random selections. Note Tutor 
indicates incorrect responses with a short 
message, then correctly names the note for 
the student. This process is continued until 
all the notes are named correctly or the user 
presses Q to stop the program. 

If the student presses K (to indicate 
keyboard position), the computer again 



CoGo 3 



♦ 




120 122 570 106 1040 175 

290 .......... 126 670 206 1120 ..11 

.,.,. 29 820 57 END 113 

m 126 910 88 
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490 



The Listing: N0TETUTR 



10 

20 

30 

40 

50 

60 

70 

80 RGB:PALETTE1.0:PALETTE 0.63:D 

IMN(22).MS$(11):HSCR£EN4:HBUFF1. 



NOTE TUTOR 

WRITTEN BY WILLIAM MILLER 
COPYRIGHT (C) OCTOBER 1991 
BY FALS0FT. INC. 
RAINBOW MAGAZINE" 
INTRO MEMORY. SCREEN 



100:HBUFF2.100:HBUFF3.100:HBUFF4 
. 100 :HBUFF5. 500 :HBUFF6. 1000 :HBUF 
F7. 1000 :HBUFF8. 500 :HBUFF9. 500 :TC 
$-"FGABCDEFGABCDEFGABCDEF" :BC$=" 
CDEFGABCDEFGABCDEF":CC-1:X-112 
85 HPRINT(35.1)."N0TE TUT0R":HPR 
INT (34.2)."WKM Software" :HPRINT 
(38. 3). "7/91" 
90 • 
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randomly places a note on the staff. Using 


Other Possibilities 


are the addition of accidentals (sharps and 


a mouse or joystick, the student must put 


The variables I used in Note Tutor are 


flats), and a provision for naming the hand 


the blinking-line cursor over the correct 


shown in Figure 1 . Figure 2 provides a very 


positions for chords. Then again, that could 


key and press the fire button. Correct and 


general description of the routines involved 


be another complete program. 


incorrect responses are handled in the 


in the program. Two enhancements pro- 


I hope you enjoy using Note Tutor as 




manner described above. 


grammers may want to add to Note Tutor 


much as I enjoyed writing it. □ 






100 ' MESSAGES 


290 ' 


E(32.38).5:HPAINT(33.37).1.1:HPA 






110 • 


300 ' DRAW STAFF 


INT(33.39).1.1:HCIRCLE(44.38).16 






120 MS$(l)-"Choose one":MS$(2)-" 


310 ' 


,1.1..47..15:HDRAW"BM58.42;L2D2L 






<T>reb1e Clef":MSS(3)-"<B>ass CI 


320 FORZ -59 TO 31 STEP-7 :HL1NE( 


2D2L2":HC1RCLE(29.40).27.1.1..1, 






ef":MS$(4)-"Find <N>ote":MS$(5)~ 


10.Z)-(210.Z).PSET:NEXT:HLINE(10 


.25:HCIRCLE(68.35).3:HPA1NT(68.3 






"Find <K>eyboard pos1tion":MS$(6 


,31)-(10.59).PSET:HLINE(11.31)-( 


5).1.1:HCIRCLE(68.41).3:HPAINT(6 






)-"Note:":MS$(7)-"Press <Q> to q 


11.59).PSET:HLINE(16.31)-(16.59) 


8. 41). 1.1 


■ 




uit":MS$(8)-"Keyboard Position": 


,PSET:HGET( 180.0) -(194.90). 5 


440 HGET(25.25)-(73.65).7:HPUT(2 






MS$(9)-"Sorry. the note is: " 


330 ' 


5.25)-(73.65).6 






130 MS$(10)-"Correcf':MS$(ll)-"S 


340 ' DRAW KEYBOARD 


450 ' 






orry, the key is:" 


350 ' 


460 • DRAW TREBLE CLEF 






140 GOTO300 


360 FORZ=0TO21:FORA-0TO1:HLINE(1 


470 ' 






150 ' 


95+20*Z-A*140.70+A*40)-(215-A*14 


480 HCIRCLE (44.53) .12. 1 . 1 . .45 . . 






160 ' SUBS 


0+20*Z.100+A*40).PSET.B:lFZ=3 OR 


28:HCIRCLE(42.51).18.1.1..28..70 






170 ' 


Z-6 OR Z-10 OR Z-13 OR Z-17 OR 


:HDRAW"BM32.45:R2UR2UR2UR2UR2UR2 






180 ' INKEY 


Z>19 THEN 370 ELSE HLINE(211+20 


UR2UR2:U2R2U2R2U2R2;U3LULULUL3DL 






190 Q$-INKEY$:IFQS-""THEN 190 EL 


*Z-A*140.70+A*40)-(220+20*Z-A*14 


DLDLD33L2DL2DL4U2RDLU":HGET(25.2 






SE RETURN 


0.85+A*40).PSET.BF 


5)-(73.65).6 






200 • 


370 NEXT A.Z 


490 • 






210 • PRINT MESSAGE 


380 FORZ- TO 6:HLINE(2+20*Z. 15 


500 ' INTRO NOTES 






220 ' 


0)-(12+20*Z.180).PSET.B:IF Z-2 


510 HCIRCLE (100,56).5:HPAINT(10 






230 HPRINT(PX.PY).MS$(MS):RETURN 


R Z-6 THEN 390 ELSE HLINE(15+20* 


0.56).1.1:HLINE(104.59)-(104.42) 






240 ' 


Z.150)-(19+20*Z.170).PSET.BF 


.PSET:HL I NE( 105.59) -( 105.42). PSE 






250 ' ERASE MESSAGE 


390 NEXT 


T:PLAY"03;F" 






260 ' 


400 ' 


520 HCIRCLE ( 120.52) .5:HPAINT(12 






270 HCOLOR0:GOSUB230:HCOLOR1:RET 


410 ' DRAW BASS CLEF 


0.51).1.1:HPAINT(120.53).1.1:HLI 






URN 


420 ' 


NE( 124. 54) -( 124.35). PSET:HLINE(1 






280 • 


430 HGET(25.25)-(73.65).6:HCIRCL 


25.54)-(125.35).PSET:PLAY"03:G" 





SUPER SUPER SPECIAL 



All 530 Public Domain Programs-$145 Value 
All 1,020 Subscription Programs-$260 Value 
All 250 Graphic Pictures-$70 Value 

ENTIRE PACKAGE Regularly $475 




$279.°°! 

y™ SEE PAGE 23 FOR DETAILS w 

T&D Subscription Software • 2490 Mies : 




Each Set Of 10 Disks 

Only $35.00 ! 
Buy 2, Get One Free! 



Set #1 Set #2 Set #3 

Clipart Celebrities Adult Only 

Space Pictures Cartoon Characters R-Rated 

Animals Great Graphics Beautiful Women 

More More 



Subscription Software • 2490 Mies Standfeh Dr., Holland, Mi 49423 • 616-399-9648 
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About 

Your 

Subscription 



Your copy of THE rainbow is sent 
second class mail. You must notify us of 
a new address when you move. Notifica- 
I ion should reach us no later than the 1 5th 
of the month prior to the month in which 
you change your address. Sorry, we can- 
not be responsible for sending another 
copy when you fail 10 notify us. 

Your mailing label also shows an ac- 
count number and the subscription expi- 
ration date. Please indicate this account 
number when renewing or correspond- 
ing with us. It will help us help you better 
and faster. 

For Canadian and other non-U. S. sub- 
scribers, there may be a mailing address 
shown that is different from our editorial 
office address. Send your correspondence 
to our editorial offices at Falsoft. Inc.. 
The Falsoft Building. P.O. Box 3S5. Pros- 
pect. KY 40059. 




530 HCIRCLE ( 145.42) .5:HPAINT( 14 
5.42 ).1.1:HLINE( 140.40) -(140. 57) 
. PSET:HLINE( 139.40) -(139. 57 ).PSE 
T:PLAY"04;C" 

540 HCIRCLE ( 165.38) .5:HPAINT( 16 
5.39).1.1:HPAINT(165.37),1,1:HLI 
NE( 160.36) -(160. 53). P5ET:HLINE(1 
59.36 )-( 159. 53). PSET : PLAY"04 : D" 
550 HGET(92.62)-(106.41).1:HGET( 
112. 58) -( 126.37 ),2:HGET( 150. 39)- 
(136,60).3:HGET(170.34)-(156.55) 
,4 

560 ' 

570 ' CHOOSE TREBLE CLEF OR BASS 
CLEF AND CHOOSE KEYBOARD OR NOT 
E 

580 ' 

590 HLINE(415.30)-(635.61).PSET. 
B:HL1NE(415.30)-(635.61).PSET.B: 
HLINE(415.30)-(633.60).PSET.B:PX 
=53:PY-4:MS=1:GOSUB230:PX-55:PY= 
5 : MS=2 : GOSUB230 : PY=6 : MS-3 : G0SUB2 
30 

600 GOSUB190 

610 IF 0J-"T"THEN CC-1 ELSE IF 
$="B" THEN CC-2 ELSE 600 
620 GOSUB270:PY-5:MS-2:GOSUB270 
630 PX-55:PY=5:MS=4:GOSUB230:PY= 
6:MS=5:GOSUB230 
640 GOSUB190 

650 IFQ$="N"THEN KN-1 ELSE IF Q$ 
-"K"THEN KN-2 ELSE 640 
660 HPUT(112.0)-(126.80).5:HPUT( 
92.0) - (106.80). 5 :HPUT( 136.0) -(15 
0.80). 5:HPUT( 156.0) -U70.80).5 

669 PL-1 

670 GOSUB270:PY=5:MS=4:GOSUB270: 
PX-53:PY-4:MS-1:GOSUB270:PX-55:P 
Y=6:MS=7:GOSUB230:IFKN-1THEN PX- 
55:PY-4:MS-6:GOSUB230 ELSE PX-55 
:PY=4:MS-8:GOSUB230 

680 ' 

690 ' INITIALIZE NOTE BUFFER 

700 ' 

710 IF CC-1 THEN N$=TC$ :HPUT(25. 

25)-(73.65).6 ELSE N$=BC$ :HPUT(2 

5.25)-(73.65).7 

720 F0RZ=1T022:N(Z)=Z:NEXT:IFCC- 

I THEN TN-22 ELSE TN-18 
730 ' 

740 ' MAIN LOOP 

750 ' 

760 ' GET RANDOM NOTE 

770 PL=RND(TN):N=N(PL) 

780 N0$-MID$(N$.N.1):IF CC-1 THE 

N 830 

790 ' 

800 ' DEFINE OCTAVE 

810 ' 

820 IF N>14 THEN 0C-3 ELSE IF N> 
7 THEN 0C =2 ELSE 0C-1 

821 GOTO840 

830 IF N>18 THEN 0C-5 ELSE IF N> 

II THEN 0C=4 ELSE IF N>4 THEN 0C 
-3 ELSE 0C =2 

840 0C$="0"+STR$(OC) 

850 0E-(N-2*(INT(N/2))):IFCC=2 T 

HEN 910 

860 • TREBLE CLEF DEFINE NOTE VA 

RUBLES 

870 IF 0E-1 AND N<11 THEN BF-2 E 

LSE IF OE=0 AND N<11 THEN BF-1 E 

LSE IF 0E-1 AND N=>11 THEN BF-4 

ELSE BF-3 

880 IF N>10 AND OE-0 THEN Y-98 E 

LSE IF N>10 AND 0E-1 THEN Y-97 E 

LSE Y-86 



890 GOTO 930 

900 ' BASS CLEF DEFINE NOTE VARI 

ABLES 

910 IF 0E-1 AND N<9 THEN BF-2 E 

LSE IF OE=0 AND N<9 THEN BF-1 EL 

SE IF 0E-1 AND N->9 THEN BF-4 EL 

SE BF-3 

920 IF N>8 AND £E-0 THEN Y-91 EL 

SE IF N>8 AND 0E-1 THEN Y-90 ELS 

E Y-79 

930 NN-N-1 

940 ' 

950 ' PUT NOTE ON STAFF 

960 ' 

970 HPUT(X.Y-INT(3.5*NN))-(X+14. 

Y-21-INT(3.5*NN")).BF:PLAY 0C$+": 

"+N0$:IFKN-2 THEN1120 

980 ' 

990 "CHECK ANSWER FOR FIND NOTE 

1000 ' 

1010 GOSUB190 

1020 IF 0$-"0" THEN END ELSE IF 

Q$<"A" OR 0$>"G" THEN 940 

1030 HPRINT(61.4).Q$ 

1040 IF 0$<>N0$ THEN SOUND100.2: 

SOUND50.3:HCOLOR3:PX-55:PY=5:MS- 

9:GOSUB230:HPRINT(75.5).NO$:FORT 

=1TO1000:NEXT:GOSUB270:HCOLOR0:H 

PRINT(75.5).N0$:HPRINT(61.4).Q$: 

HCOLOR1:HPUT(X.0)-(X+14.90).5:GO 

TO760 

1050 ' RIGHT ANSWER 

1060 SOUND200.1:FORT-1TO50:NEXT: 

SOUND200.1:HCOLOR2:PX=55:PY-5:MS 

-10:GOSUB230:FORT-1TO500:NEXT:GO 

SUB270 

1070 FORZ-PL TO 21:N(Z)-N(Z+1):N 

EXT:TN-TN-1:GOSUB270:IF TN-0 THE 

N HCOLOR0:HPRINT(61.4).O$:HPRINT 

(75.5).NO$:HCOLOR1:HPUT(X.0)-(X+ 

14,90).5:PX-55:PY-5:MS-10:GOSUB2 

70 : PY-4 : MS-6 : GOSUB270: PY-6 : MS-7 : 

GOSUB270:PX=55:PY-4:MS-8:GOSUB27 

0:GOTO590 

1080 FORT-lTO500:NEXT:PX-55:PY-5 

:MS-9:GOSUB270:HCOLOR0:HPRINT(75 

.5).N0$ 

1090 IFKN-1 THEN HPRINT(61 .4 ) .Q$ 

1100 HCOLOR1:HPUT(X.0)-(X+14.90) 

.5 

1110 GOTO770 

1120 ' 

1130 • CHECK ANSWER FOR KEYBOARD 

POSITION 
1140 ' 

1150 Q$-INKEY$:IFQ$-"Q" THEN END 
1160 JP-JOYSTK(0): IF INT(JP/2)*2 
OJP THEN JP-JP-1 
1170 HGET(6+JP*10.70)-(6+JP*10+5 
,180).9:HLINE(6+JP*10.70)-(6+JP* 
10+1.180).PSET.BF:HPUT(6+JP*10.7 
0)-(6+JP*10+5.180).9:IF BUTTON ( 
0)-0 THEN 1150 

1180 HC0L0R3:IF CC-1 THEN NT-(N+ 
9)*2 ELSE NT-(N-1)*2 
1190 IF NT-JP THEN 1060 
1200 'WRONG ANSWER 
1210 PX-55:PY-5:MS-11:GOSUB230 
1220 SOUND100.2:SOUND50.3:FORT-1 
TO10: HGET(6+NT*10.70)-(6+NT*10+ 
5.180).9:HLINE(6+NT*10.70)-(6+NT 
*10+1. 180). PSET. BF:HPUT(6+NT*10. 
70)-(6+NT*10+5.180).9:NEXT:HCOLO 
Rl 

1230 PX=55:PY-5:MS-11:GOSUB270:H 
PUT ( X . ) - ( X+l 4 . 90 ) . 5 : GOTO770 



and smell the CoCo! 




Bring your drawings and 
designs to vivid, colorful 
life with the amazingly T 
popular CoCo Max III! 

Zoom! Rotate! Animate! 13 Fantastic Fonts! 40 paint 
brush shapes! CoCo Max III dazzles the eye! Get crisp, clear picture reso- 
lution ( two full hi-res 320* 192 screens ) . . . a big, big edit window ... 28 
"eat-your-heart-out" drawing tools. Rotate at miniscule 1 .5° angles. 
Undo boo-boos with a dick. Animate for special effect. Pick'n'choose from 
16 colors out of 64. Go absolutely fruity with fonts (8 sizes, 5 styles & 
more available! ) and an astounding 40 different brush styles! No wonder 
this software is recognized as the CoCo community's all-time favorite! 
Works with both l28Kand 5I2K. Colors prim in 5 shades of gray. Primers supported: 
Epson RX, FX_ MX. IX and compatibles: Star/Gemini NX-10, NX- 1000: DMPI00. 105, 
106, 110, 120, 130, 200; OKI 82A. 182. I92CGP-220IB&W). 

CoCo Max m Add Ons 

Max Fonts disks: 93 fonts on 4 disks Noworuy$29.95 

Or two sets of two disks each $14.95 

Max Edit The font editor as creative as your imagination Only $14.95 
Color Printer drivers NX- 1000 Rainbow. CGP-220 and 
Okimate 20. For glorious color that wins hands down! $14.95 




Get Max-10 -the CoCo 
word processor that's 
fun and furiously fast! 

Get that easy-as-pie Macintosh feel without giving 
up your first-born! This program will stretch your CoCo to the limit. Mix 
graphics, text, large headlines, arrange multiple columns, you name it . . . 
Max- 10 will swiftly oblige. Includes paper-saving full-page preview 
( graphics, too! ) to make your prose look proud. This is the CoCo word 
processor that will leave vou speechless. Printers supported: Epson FX, 
MX. RX, LX and compatibles; DMP 103, 106. 130; CGP 220 ( B&W); OKI 
182, 92, 192; STAR NX-10, NX- 1000. 

Max-10 Add-Ons 

Max- 10 Fonts 36 super fonts on 2 disks. Call for list .... Now $14.95 
Spell Checker 33,000 word dictionary. Online spell checking 
to make you look the perfect professional $1 4.95 



Buy both CoCo Max III 
andMax-10 




Call 1 -800-221 -0916 1 -203-259- 7713 



How to order: Use Visa, Mastercard or M.O. C.O.D. add $4.00 extra. Purchase Orders 
subject to credit approval Connecticut residents add 8% sales tax. Shipping $4.00 per order, 
usually ITS ground. IPS 2nd day air $6.00 extra. Next day service available. Canada: 
$6.00 per order (Airmail )'. Outside US. & Canada add 10°o of order total. 



[COLORWARE 



303 Lin wood Ave. 
Fairfield, CI 06430 




Advertisers Index 



We encourage you to patronize our advertisers — all of whom support the Tandy Color 
Computer. We will appreciate your mentioning the rainbow when you contact these firms. 



Burke & Burke 37 

CoCoPRO! 13 

CoCoPRO! 33 

CoCoPRO! 35 

Colorware 63 

Computer Plus IFC 

Dayton Associates 

ofW.R. Hall. Inc 56 

Dayton Associates 

ofW.R. Hall, Inc 57 

Dclmar Company 17 



Delphi 7 

Delphi BC 

Eversoft Games, Ltd 47 

Frank Hogg 45 

Granite Computer Systems 39 

Hawksoft 37 

IMS 65 

JWT Enterprises 33 

MV Systems 15 

NRI 51 

Owl-Ware 26 



Owl-Ware : 27 

PCM Magazine 66 

Rainbow Back Issues 9 

Rainbow Bookshelf 27 

Spectra Systems 39 

Sundog Systems 35 

Sundog Systems IBC 

T & D Software 23 

T & D Software 61 

Trading Post 21 

Zebra Systems 3 1 




Call: 
Belinda Kirby 



Advertising Representative ^^ 



(502) 228-4492 





□ Call: 

Kim Lewis 

Advertising Representative 

(502) 228-4492 



The Falsoft Building 
9509 U.S. Highway 42, P.O. Box 385, Prospect, KY 40059 

FAX (502) 228-5121 
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OSK.. 



is OK! 



Moving forward A 

Interactive Media Systems. Inc. joins the software 
vendors below in welcoming OS-9/68000™ to our 
community. New windowing software from Kevin Dar- 
ling, along with excellent support from HyperTech Soft- 
ware, has made many of your favorite programs avail- 
able now, with the added power of fast computing and 
colorful graphics. 

IMS, Inc. is shipping its MM/1 IM computer, and other 
companies are offering OSK systems. We encourage 
you to find out about these systems and the new, 
exciting software soon available on them. Call StG and 
ask about windows utilities; call Color Systems and ask 
about label printing software. Call CoCoPro! and ask 
about moving around OSK directories; and call Ani- 
Majik about their keyboards, hard disk drives, and 
telecom software. Try Burke & Burke for their world- 
class utilities and programming tools; then telephone 



Burke & Burke 

Chris and Trisha Burke -- 206-432-1814 
Dialog Box Manager • File System Repack 

HyperTech Software 

Mike Haaland -- 702-362-5346 
Fontasee for the MM/1 ■ Paint • CGFX 

AniMajik Productions 

Alan Sheltra -- 818-761-4135 

OS-9 and OSK software and hardware 

BeW Software 

Brett E. Wynkoop -- 212-567-7617 

BeW Utilities • UUCP support • Send Fax coming soon 

Color Systems 

Zack Sessions -- 919-675-1706 

For the MM/1 : Variations on Solitaire • Sub Battle • 

Yah'zee 



Brett at BeW Software about making the most 
out of the Bourne Shell and UUCP. Kala Soft- 
ware, JWT, and others, are creating your future. 

We are your community A 

IMS. Inc. and all the vendors below are staffed by 
long-time Color Computer supporters. They are 
bringing you the next generation of computing. 
Their hard work is a symbol of their commitment to 
the most important component of the Color Com- 
puter. That's you. 

Pick up the phone and call these companies. See 
how you can be a part of this new, exciting future. 
Thank you. 

-- Interactive Media Systems, Inc. 



CoCoPro! Software 

Dave Myers -- 31 3-481 -DAVE 

For the MM/1: Presto Partner, Data Windows; OSK: The Zapper 

JWT Enterprises 

Jordan W. Tsvetkoff 

Nine Times Disk Magazine • Optimize" Utility Set for OS-9/OSK 

Kala Software 

Ed Hathaway - 919-333-1657 

Call for catalog! Watch for UltiMuse/K for the MM/1! 

StG Computing, Inc. 

Scott Griepentrog - 317-241-6401 

StGNet • DB9 Multimedia Database • OSK and MM/1 Utilities 

Interactive Media 
Systems, Inc. 
202-232-4246 

Call for brochures on these and other fine products 





Subscribing now means immediate savings! 

Due to the increased cost in postage and printing, PCM now faces its first price increase ever. But you can 
take advantage of the opportunity to beat the high cost of inflation and SAVE UP TO 31% off the cost of 
PCM — if you act now! We don't want you to miss a single issue of PCM. and this is your chance to continue 
to receive PCM at the current subscrition rates. Act today! Return the subscription order form found in this 
issue of PCM or call our toll-free number (800-847-0309) to place your order. Multiple-year subscriptions 
will be added to your existing subscription. This offer is good for a limited time only. 



Check these savings! 

1-year Subscription Price before October 1. 1991 
1-year Subscription Price after October 1, 1991 



2-year Subscription Price before October 1. 1991 
2-year Subscription Price after October 1. 1991 

3-year Subscription Price before October 1. 1991 
3-year Subscription Price after October 1. 1991 



Uniied 

Slaies 


Canada 
& Mexico 


Foreign 
Surface 


Foreign 
Air Mail 


$28 
$34 


$38 
$46 


$64 

$78 


$103 
$126 


$51 
$62 


$71 
$87 


$123 
$150 


$201 

$245 


$71 
$87 


$101 
$123 


$179 
$218 


$296 
$361 




Belter men man you nave tailed the quest, bul the hand of the qood 
pnneess Theida is loo much lo resist! Stolen bv the evil necromancer 
Divinax. she has been secreted tar trom prying eyes and It ts now up 
to you to regain the pieces ot the mystical Life Force and save the lair 
lady Ihe Quasi lor Theida is an outstanding arcade program that 
combines action and adventure to bring you an incredible video game 
playing experience. Travel throughout over 500 dilterent screens 
searching tor magical objects and spells, lighting horrible creatures, 
and gathering the various parts ol the Lite Force guarded by ever- 
increasing terrors. You'll enjoy the highest quality 320x200 resolu- 
tion 16 color graphics and digital sound effects that you've come to 
expect Irorn Sundog Systems Ihe game play is last and tunous, and 
only you can rescue the princess and complete the LEGEND OF 
THELDAI Req. 128K CoCo 3. disk 
drive, and joystick |2-ouiton 
joystick, supported! 

Hint book now available lor Theida! Contains clues, maps, and even ; 
a BASIC program lo modlly your own characters 1 $4.95 , 



in the year 2671 , a mysterious object landed on Earth, heralding Ihe 
alien invasion ot the Red Falcon. Only two courageous soldiers have a 
(rape ol stemming Ihis alien infestation Armed with your military 
training and the latest weapon technology, you and a triend must 
light back Ihe horde. Sundog Systems presents our second 512K 
game, The Central, You'll see why we decided to use 512K on this 
project 1 Amazing graphics with 320x225 resolution. t6 color lull 
screen animation and horizontal smooth scrolling! Background digital 
sound effects and real-lime music! One or two player action AT THE 
SAME TIME! You'll agree thai this Is one of the best arcade games 
yet for your 5I2K CoCo 3. Needless to say. playing hero won't be 
easy; playing The Contras wilt be 
tougher! Req. 512K CoCo 3, disk 
drive, and 2-button joystick, 



$Onr a 90 



$34.95 



The superior technology ot the evil Overlords has ensnared yet 
another innocent planet, however, this one contains the Crystal City, 
bastion ot democracy and independence. Earth has had enough! 
Break through level upon level of their virtually invulnerable 
delenses. detest the end guardians, and make your way ever closer 
to freeing Ihe slaves ot the Crystal City' This amazing arcade gamo Is 
an achievement In its own right Full 128K/512K uiliizalioni Super 
fast horizontal hardware scrolling on the 128K computed Wild digital 
sound effects and background music score! 30 minutes, or over 30 
megabytes, ol non-repeating 320x200 resolution, 16 color graphics! 
This gams has it all: order a demo disk to see It ilrst! Can you save 
the Crystal City trom unbeatable 
toes' Req. 128K CoCo 3, disk 
drive, and Joystick 



$34.95 




SinisfaaR J&JtWttiAf 



!-:j>JL^!Z.<~.^i: 







You've raved aboul this 5I2K arcade 
game! The graphics and animation are 
amazing! You've got to hear the digital 
sounds! 512K (three disks! packed with 
excitement. 512K CoCo 3 only. S34.95 



This martial arts arcade game remains a 
CoCo 3 phenomenon. One ot our best sell- 
ers lo dale! Play the incredible combat ex- 
perience lhal you've been missing, and call 
tor the availability ol the OS-9 version. 
128K CoCo^acUofl, $29.95. 

OS-9 Version Now Available 



ALSO AVAILABLE: 



You have been chosen to pilot the spacecraft wielding the piutonium 
plasma laser againsl the netarious insectoWs, the Zenlans. These 
bugs have been ripping off the space trade lines for years; now 
they're about to tind a victim who can light back! Beat back the 
swarm of pests to their home planet Zenix. and use the laser to end 
the menace once and for all. Zenfx Is a lightning last arcade game lor 
the 128K CoCo 3 The 320x225 16 color graphics are amazing, as 
are the digital background music score and effects, all on 8 128K 
computer! The fast action and game play will astound you In this 
GALAGA ot extermination. Plug in your Joystick and strap in lor the 
ride of your lite! Call to order a demo* 
disk to see the action betore you 
buy! Req. 128K CoCo 3, disk drive, 
and joystick. 



Hall of the King 1, 2, or 3 

CoCo 1-3 $29.95 ea. 



Kung-Fu Dude 
CoCo 1 - 3 



this 128K/512K sound sequencing system 
has become an immensely popular pro- 
gram Create musical scores using poly- 
phonic digitized sounds and a user-friend- 
ly point and click editor. Call lo order the 
SoundTrax demo program, and get 10% off 
your purchase with receipt. $34 95 
Now Available: SoundTrax instrument sam- 
ple disks! Guitars, strings, woodwinds, 
and jus! (Wain weird instruments for your 
composing pleasure: Completely compati- 
ble with the SoundTrax syslem 3 Hippy (2 
sides) disks full ot sounds. $12.95 each or 
$29.95 lor all three. 



$24.95 



$29.95 



Visa, Mastercard. Check, Money Order, and COD 
(USA only, please) accepted. All loreign orders 
must be senl in US currency Money Orders Include 
$2.50 lor shipping in USA and Canada $5 00 
Foreign S3 00 extra lor COD orders PA residents 
add 6% sales tax Dealer inquiries welcome 
Authors were looking lor new software 1 



Hall of the King Trilogy 


$74.95 


White Fire of Eternity 
CoCo 1 - 3 


$19.95 


Dragon Blade 

CoCo 1 - 3 


$19.95 


Champion 

CoCo 1 - 3 


$19.95 


Paladin's Legacy 
CoCo 1 - 3 


$24.95 


Warrior King 

CoCo 3 


$29.95 


In Quest of the Star Lord 

CoCo 3 $34.95 
Hint Sheet $ 3.95 




ciiopoa 



We've 
Moved! 



s t ysteros 

P.O. Box 766 
Manassas, V A 22111 
703/330-8989 




Being online never felt so fine, 

Join the online network with personality. The most interesting 
conferences. 1 0,000 programs you can download for your own 
use. All the most popular services. 
Two membership plans: $6 an hour or 
$1 an hour with the 20/20 Advantage. 



Free Membership 
Dial by modem, 
1-800-365-4636 



Join us online, the water's fine. 



Press return. At password, 
type RB22 



DELPHI 



Voice, 1-800-695-4005 
617-491-3393 




